GitHub Pages 部署路线

梳理本博客从本地开发到 GitHub Pages 自动发布的基本流程。

工程实践GitHub Actions部署静态站点

这个博客会部署到 GitHub Pages。理想流程是：本地写文章，推送到 GitHub，然后由 GitHub Actions 自动构建并发布。

推荐仓库名

如果这是个人主页博客，推荐使用：

your-github-username.github.io

这样发布地址就是：

https://your-github-username.github.io

如果你使用普通仓库名，例如 MyBlog，地址会变成：

https://your-github-username.github.io/MyBlog/

当前配置已经尽量兼容这两种情况。

发布流程

后续常规操作会是：

npm run build
git add .
git commit -m "Add new post"
git push

推送到 main 或 master 分支后，GitHub Actions 会构建 dist/，再发布到 GitHub Pages。

上线前需要改的地方

上线前请记得修改：

  • src/consts.ts 中的作者名和 GitHub 地址
  • astro.config.mjs 中本地兜底的 your-github-username
  • GitHub 仓库设置里的 Pages 发布源，选择 GitHub Actions