基于 vhAstro-Theme 定制，保留 Astro 静态生成结构
Astro博客
Blog-Astro — Astro 博客模板
作者 HeLongaa
基于 Astro 的个人博客主题，在 vhAstro-Theme 基础上做了个性化改进，采用 MIT 许可。
看看你的网站会是什么样
浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局，交互效果请以实际项目为准。
采集于 2026-10-12查看来源
值得关注的模板亮点
从已有项目资料中，快速了解它的特点。
支持暗色/亮色主题切换与响应式布局
内置全文搜索、文章目录、评论集成与 RSS 订阅生成
支持 Markdown 与 MDX，含代码高亮与 KaTeX 数学公式
提供文章字数统计、阅读时间与置顶功能
采用 MIT 许可，可免费使用、修改、商用与分发
模板详细介绍
Blog-Astro 是一个基于 Astro 静态站点生成器构建的个人博客主题，由 HeLongaa 在 vhAstro-Theme 基础上进行深度定制和功能增强，采用 MIT 开源协议。主题面向个人博客与技术分享场景，提供暗色/亮色主题切换、响应式布局、全文搜索、文章目录、评论集成、RSS 订阅、站点地图、SEO 配置、图片懒加载等模块，并支持 Markdown 与 MDX 写作、代码高亮、KaTeX 数学公式渲染、文章字数统计与阅读时间、文章置顶。内容管理通过 src/content/blog/ 下的 .md 或 .mdx 文件完成，frontmatter 包含标题、日期、分类、标签与封面字段；站点信息集中在 src/config.ts 中配置。项目使用 TypeScript 与 Less，包管理采用 PNPM，README 要求 Node.js 18+ 与 PNPM 8+，并给出 Vercel、Netlify、GitHub Pages 的部署方向。友链管理与 RSS 订阅功能依赖作者提供的 CloudFlare 相关外部项目，并非主题内置的独立服务。
Astro博客
适合你的项目吗？
适用场景
- 搭建个人技术博客并发布 Markdown/MDX 文章
- 需要暗色模式、全文搜索与文章目录的阅读型站点
- 希望通过 RSS、站点地图与 SEO 配置提升内容分发
- 在 Vercel、Netlify 或 GitHub Pages 上部署静态博客
适合人群
- 有前端基础、愿意自行配置 src/config.ts 的个人开发者
- 使用 Astro 或希望尝试 Astro 静态站点的技术写作者
- 需要 MIT 许可下可自由修改的博客主题的用户
- 能接受友链与 RSS 订阅依赖外部 CloudFlare 项目的使用者
上手与定制指南
结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。
- 1
环境要求 Node.js 18.0+ 与 PNPM 8.0+。
- 2
克隆仓库后执行 pnpm install 安装依赖，pnpm dev 启动开发服务器，pnpm build 构建生产版本。
- 3
修改 src/config.ts 设置站点地址、标题、作者与描述等信息。
- 4
文章放在 src/content/blog/ 目录，使用 .md 或 .mdx，并在 frontmatter 中填写 title、date、categories、tags、cover 等字段。
- 5
友链管理与 RSS 订阅功能依赖作者提供的 CloudFlare 相关外部项目，需另行部署；演示图片、字体、图标等第三方素材需按各自许可核对。
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供；担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
- 友链管理与 RSS 订阅功能依赖作者提供的 CloudFlare 外部项目，需另行部署，并非主题内置的独立服务。
- 友链申请功能依赖外部仓库 links-app-workers，需单独部署该 CloudFlare 项目才能使用。
- RSS 订阅功能依赖外部仓库 RSS-Subscription，需单独部署该 CloudFlare 项目才能使用。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
- ✅ 基于 CloudFlare 的友链管理 - ✅ 基于 CloudFlare 的RSS订阅
README 原文
[**🔗 友链申请功能**](https://github.com/HeLongaa/links-app-workers)
README 原文
https://github.com/HeLongaa/Blog-Astro/blob/main/LICENSEhttps://github.com/HeLongaa/Blog-Astro/blob/main/README.md[**<img src="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='20' height='20' fill='%23FFA500' viewBox='0 0 24 24'><path d='M6.18 17.82a2.18 2.18 0 1 1 0-4.36 2.18 2.18 0 0 1 0 4.36zm-3.18.18v-3a1 1 0 0 1 1-1c8.28 0 15 6.72 15 15a1 1 0 0 1-1 1h-3a1 1 0 0 1-1-1c0-6.08-4.92-11-11-11a1 1 0 0 1-1-1zm0-6v-3a1 1 0 0 1 1-1c12.15 0 22 9.85 22 22a1 1 0 0 1-1 1h-3a1 1 0 0 1-1-1c0-10.49-8.51-19-19-19a1 1 0 0 1-1-1z'/></svg>" alt="RSS" style="vertical-align:middle;" /> RSS订阅功能**](https://github.com/HeLongaa/RSS-Subscription)
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-12。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 77 / 100
- 技术栈
- Astro
- 网站类型
- 博客
这个分数如何计算
本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2025-08-28
- 截图检查日期
- 2026-10-12
已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
审核声明: [email protected] · 2026-10-13
查看当时使用的来源资料
SHA-256: 09038de4443e14043dfcad0a4ce06362964d92603e6b501a1236f132240500e7
2026-10-12T18:34:43.986Z
来源文件 / 仓库# 🌟 HeLong's Blog - Astro Theme
> 🚀 一个基于 Astro 构建的现代化个人博客主题，具有优雅的设计和丰富的功能
[**🌐 在线预览**](https://blog.helong.online/) | [**📚 文档**](#功能特性) | [**🛠️ 部署指南**](#快速开始) | [**🔗 友链申请功能**](https://github.com/HeLongaa/links-app-workers) | <a href="https://github.com/HeLongaa/Talking-server" style="text-decoration:none;"><svg t="1753625653712" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="1506" width="20" height="20" style="vertical-align:middle;"><path d="M26.564738 707.028587c0 170.262396 138.02638 308.274993 308.274993 308.274993s308.274993-138.02638 308.274993-308.274993c0-170.262396-138.02638-308.274993-308.274993-308.274993S26.564738 536.779973 26.564738 707.028587zM880.936312 93.496851a47.664926 47.664926 0 1 0 0 95.329852 47.664926 47.664926 0 1 0 0-95.329852z m0 0" fill="#FFCA5F" p-id="1507"></path><path d="M383.889744 451.235316c-24.683499 0.013782-45.79747 18.481615-49.146487 43.068641l-0.468587 5.388748-0.013782 48.04393c0.165384 27.260727 22.395693 49.339435 49.628856 49.339435h0.303204c24.40786-0.151602 45.397793-18.481615 48.843283-42.627618l0.482369-5.54035 0.013782-48.030148c-0.013782-27.370983-22.285437-49.642638-49.642638-49.642638z" fill="#5C1CF7" p-id="1508"></path><path d="M902.160538 953.629287l-45.700996-91.45712 5.264711-5.74708c77.509771-84.4421 120.096043-194.077631 119.916878-308.688452 0-122.121992-47.561561-236.939542-133.919354-323.297335-86.357793-86.357793-201.175343-133.919354-323.297336-133.919354s-236.939542 47.561561-323.297335 133.919354C114.769314 310.783311 67.221534 425.600861 67.221534 547.722853c0 242.548802 189.446891 443.062611 431.334159 456.513809l12.913701 0.523715 12.968829 0.192947H870.296635c9.495774 0 18.412705-3.693567 25.138304-10.405383 6.725599-6.711817 10.432948-15.64253 10.432948-25.152086 0-3.762476-0.592624-7.483607-1.75031-11.053136l-1.957039-4.713432z m-89.472516-19.84603H524.286622l-12.155693-0.179165-11.756016-0.468587C297.38035 921.186541 138.364038 751.902665 138.364038 547.722853c0-209.954455 164.391279-379.458843 374.207914-385.881238l12.086783-0.192947 11.769798 0.179165c209.761507 6.518869 374.070094 176.023257 374.070094 385.881238 0.165384 91.18148-32.236016 179.675478-91.18148 249.177928l-10.074617 11.480377-38.355208 41.800699 41.8007 83.615182z" fill="#5C1CF7" p-id="1509"></path><path d="M664.972921 451.235316c-24.683499 0.013782-45.79747 18.481615-49.146488 43.068641l-0.468586 5.388748-0.013782 48.04393c0.165384 27.260727 22.395693 49.339435 49.628856 49.339435h0.303203c24.40786-0.151602 45.397793-18.481615 48.843284-42.627618l0.482369-5.54035 0.013782-48.030148c0-27.370983-22.271655-49.642638-49.642638-49.642638z" fill="#5C1CF7" p-id="1510"></path></svg> <strong>说说后端</strong></a> | [**<img src="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='20' height='20' fill='%23FFA500' viewBox='0 0 24 24'><path d='M6.18 17.82a2.18 2.18 0 1 1 0-4.36 2.18 2.18 0 0 1 0 4.36zm-3.18.18v-3a1 1 0 0 1 1-1c8.28 0 15 6.72 15 15a1 1 0 0 1-1 1h-3a1 1 0 0 1-1-1c0-6.08-4.92-11-11-11a1 1 0 0 1-1-1zm0-6v-3a1 1 0 0 1 1-1c12.15 0 22 9.85 22 22a1 1 0 0 1-1 1h-3a1 1 0 0 1-1-1c0-10.49-8.51-19-19-19a1 1 0 0 1-1-1z'/></svg>" alt="RSS" style="vertical-align:middle;" /> RSS订阅功能**](https://github.com/HeLongaa/RSS-Subscription)
## 📋 项目介绍
本项目基于 [vhAstro-Theme](https://github.com/uxiaohan/vhAstro-Theme) 进行了深度定制和功能增强。这是一个使用 Astro 静态站点生成器构建的现代化博客主题，专为个人博客和技术分享而设计。
### 🔄 基于原项目的改进
感谢 [@uxiaohan](https://github.com/uxiaohan) 提供的优秀基础框架。
### ✨ 核心特色
- 🌙 **暗色/亮色主题切换** - 支持自动、手动主题切换
- 📱 **完全响应式设计** - 适配所有设备屏幕
- ⚡ **极速性能** - 基于 Astro 的静态生成，加载速度极快
- 🔍 **全文搜索** - 内置搜索功能，快速查找文章
- 📊 **数据统计** - 文章数量、分类、标签统计
- 💬 **评论系统** - 集成评论功能
- 🏷️ **标签分类** - 完善的文章分类和标签系统
## 🚀 功能特性
### 🎨 界面设计
- ✅ 现代化 UI 设计，简洁优雅
- ✅ 暗色/亮色主题自由切换
- ✅ 响应式布局，完美适配移动端
- ✅ 流畅的页面切换动画
- ✅ 自定义字体和图标支持
### 📝 内容管理
- ✅ Markdown 文档写作
- ✅ MDX 组件支持
- ✅ 代码高亮显示
- ✅ 数学公式渲染 (KaTeX)
- ✅ 文章字数统计和阅读时间
- ✅ 文章置顶功能
### 🔧 功能模块
- ✅ 全文搜索功能
- ✅ 文章目录导航
- ✅ 评论系统集成
- ✅ RSS 订阅生成
- ✅ 站点地图自动生成
- ✅ SEO 优化配置
- ✅ 图片懒加载
- ✅ 基于 CloudFlare 的友链管理
- ✅ 基于 CloudFlare 的RSS订阅
### 📊 数据分析
- ✅ 文章统计信息
- ✅ 分类和标签管理
- ✅ 访问统计集成
- ✅ 网站运行状态监控
## 🛠️ 技术栈
- **框架**: [Astro](https://astro.build/) - 现代静态站点生成器
- **语言**: TypeScript - 类型安全的 JavaScript
- **样式**: Less - CSS 预处理器
- **包管理**: PNPM - 快速的包管理器
- **部署**: 支持 Vercel、Netlify、GitHub Pages
- **工具**: ESLint、Prettier 代码格式化
## 🚀 快速开始
### 环境要求
- Node.js 18.0+
- PNPM 8.0+
### 安装步骤
1. **克隆项目**
```bash
git clone https://github.com/your-username/Blog-Astro.git
cd Blog-Astro
```
2. **安装依赖**
```bash
pnpm install
```
3. **启动开发服务器**
```bash
pnpm dev
```
4. **构建生产版本**
```bash
pnpm build
```
### 配置说明
修改 `src/config.ts` 文件来自定义你的博客设置：
```typescript
export default {
Site: "https://your-domain.com",
Title: "你的博客标题",
Author: "你的名字",
Description: "博客描述",
// ... 更多配置选项
}
```
## 📁 项目结构
```
Blog-Astro/
├── src/
│ ├── components/ # 组件目录
│ ├── content/ # 博客内容
│ ├── layouts/ # 页面布局
│ ├── pages/ # 页面路由
│ ├── scripts/ # 脚本文件
│ └── styles/ # 样式文件
├── public/ # 静态资源
└── astro.config.mjs # Astro 配置
```
## 📝 写作指南
1. 在 `src/content/blog/` 目录下创建 `.md` 或 `.mdx` 文件
2. 使用以下 frontmatter 格式：
```yaml
---
title: "文章标题"
date: 2025-01-01
categories: "分类"
tags: ["标签1", "标签2"]
cover: "封面图片路径"
---
你的文章内容...
```
## 🎯 关于作者
👋 你好，我是 **HeLong**
🎓 目前在 [云南大学](https://www.ynu.edu.cn/) 攻读计算机科学学士学位
💭 人生格言：*无论走得多远，都要记住当初为什么出发*
📝 这个博客用来记录我的学习和生活，希望能给每一位访客带来启发
### 📫 联系方式
- 📧 **邮箱**: [email protected]
- 🐙 **GitHub**: [HeLong](https://github.com/Helongaa)
- 📚 **知乎**: [想再见一面](https://www.zhihu.com/people/yu-luo-wu-sheng-73-99)
- 📺 **哔哩哔哩**: [风吹枫悠落](https://space.bilibili.com/491035693)
## 🙏 致谢
特别感谢以下项目和开发者：
- **[vhAstro-Theme](https://github.com/uxiaohan/vhAstro-Theme)** - 本项目的基础，由 [@uxiaohan](https://github.com/uxiaohan) 开发
- **[Astro](https://astro.build/)** - 强大的静态站点生成器
- 所有为开源社区贡献力量的开发者们
## 📜 开源协议
本项目采用 [MIT](LICENSE) 开源协议
## 🤝 贡献
欢迎提交 Issue 和 Pull Request 来帮助改进这个项目！
如果你觉得这个项目对你有帮助，请给它一个 ⭐️
---
<p align="center">
<strong>如果你有任何问题，欢迎随时联系我。我很乐意成为你的朋友！</strong>
</p>
看看同类模板
对比同技术栈与用途的模板，找到更适合的视觉与内容结构。
astrowind
⭕️ AstroWind: A free template using Astro v7 and Tailwind CSS v4. Astro starter theme.
Astro · 博客
astro-paper
A minimal, accessible and SEO-friendly Astro blog theme.
Astro · 博客
fuwari
✨A static blog template built with Astro.
Astro · 博客
Firefly
Firefly 是一款基于 Astro 的静态博客主题，由 CuteLeaf 在 saicaca 的 Fuwari 模板基础上二次开发，主打清新美观的视觉风格。
Astro · 博客
astro-theme-cactus
A simple Astro theme. Use it to create your blog or website.
Astro · 作品集
astrofy
Astrofy is a free and open-source template for your Personal Portfolio Website built with Astro and TailwindCS…
Astro · 作品集