github pages 无需html特殊配置，只需确保index.html在根目录或/docs目录、路径引用合法、仓库命名符合username.github.io格式（个人主页硬性要求），并等待构建完成即可访问。
GitHub Pages 不需要 HTML 文件里写任何特殊配置，所有部署逻辑都在仓库和 GitHub 后台完成。你只需要保证 index.html 在正确位置、路径引用合法、仓库设置匹配，就能访问到页面。
仓库命名必须严格符合 username.github.io 格式
这是个人主页的硬性规则，不是建议。如果用户名是 alice，仓库名必须是 alice.github.io，多一个字符、少一个点、大小写错误（比如 Alice.github.io）都会导致 Pages 不启用。
- 项目页可任意命名，但必须进 Settings → Pages 手动指定源分支或
/docs目录 - 私有仓库默认不支持 Pages，除非你开通 GitHub Pro 或 Team 计划
- 仓库名一旦创建就不能改名成
xxx.github.io格式——GitHub 会拒绝重命名，只能删掉重建
index.html 必须放在仓库根目录或 /docs 目录下
GitHub Pages 默认只认两个入口位置：主分支（main 或 master）的根目录，或 /docs 子目录。如果你把 index.html 放在 /src/index.html 或 /public/index.html，页面将 404。
- 个人主页推荐直接放根目录，避免额外配置
- 若用
/docs模式，需在仓库 Settings → Pages → Source 里选 “Deploy from a folder”，再选/docs - 相对路径引用资源（如
css/style.css）要以index.html所在位置为基准，别假设它在网站根路径下
提交后不要立刻刷新，等 GitHub 后台构建完成
首次推送或修改后，GitHub 需要约 30 秒到 2 分钟构建并分发页面。期间访问 https://username.github.io 可能显示 404 或旧内容，这不是你代码的问题。
- 可在仓库 Settings → Pages 页面查看当前状态，有绿色勾号和“Published”字样才算成功
- 如果长时间卡在 “Building” 或报错，点开 “View deployment details” 查看日志，常见错误包括
_config.yml语法错误（即使你没用 Jekyll）、大文件超限（单文件 > 100MB）、或子模块未初始化 - 强制刷新无效，浏览器缓存不是主因；真正要等的是 GitHub 的 CDN 缓存更新，通常 5–10 分钟内全网生效
最容易被忽略的是路径问题：本地双击打开 index.html 能正常加载图片和 CSS，但推到 GitHub Pages 后 404——大概率是用了绝对路径（如 /css/style.css）或协议相对路径（//cdn.example.com），而 GitHub Pages 的 URL 是 https://user.github.io/，没有根路径上下文。一律用相对路径，或者用 <base href="/"> 显式声明基准，但后者对项目页（/repo-name）不适用，得动态处理。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
