一、GitHub 上传与 GitHub Pages 发布

1. 上传代码到 GitHub

• 将本地的博客代码（index.html + assets/ + scripts/ + styles/）上传到 GitHub 仓库。
• 注意：index.html 必须在 仓库根目录。

2. 开启 GitHub Pages

• 进入仓库 → Settings → Pages

• 在 Build and deployment 配置：

  • Source = Deploy from a branch
  • Branch = main
  • Folder = /(root)（根目录）

• 保存后等待几分钟，GitHub 会生成一个访问地址：

  https://<用户名>.github.io/<仓库名>/
  
  

3. 常见问题与解决

• 404：常见原因是 index.html 不在根目录，或者部署未更新。
  • 解决：移动 index.html 到根目录；或重新触发构建（新建 .nojekyll 文件、修改 README）。
• 路径错误：静态资源要用相对路径，如 ./assets/img.jpg。
• 大小写敏感：文件名与引用必须一模一样。

二、使用 Cloudflare Pages 发布

1. 新建项目

1. 登录 Cloudflare → 点击 “创建应用呈现”—> 菜单 Pages。