2026/9/13小于 1 分钟
快速开始
半神是基于 Astro 的中文静态博客主题。它用 Content Collections 管理文章，用文件路由生成页面，用 public/ 保存不经处理的静态资源。
环境要求
- Node.js 当前 LTS 版本
- npm 10 或更高版本
安装与启动
npm install
npm run dev开发服务器默认运行在 http://127.0.0.1:4321/。
生产构建
npm run build
npm run preview构建命令会先执行 Astro 检查，再生成 dist/ 静态文件，并处理旧文章链接。不要直接编辑 dist/。
从 Hugo 迁移
| Hugo | Astro |
|---|---|
content/posts/ | src/content/posts/ |
data/ | src/data/ |
static/ | public/ |
layouts/ | src/pages/、src/layouts/、src/components/ |
hugo server | npm run dev |