文件名必须全小写、无空格和中文，且大小写严格匹配引用路径；index.html须置于仓库根目录；多版本简历推荐用ISO 8601日期前缀命名。
文件名必须全小写，且不含空格或中文
GitHub Pages 服务器运行在 Linux 环境下，对大小写敏感。你本地双击 index.html 能打开，上传后变成 Index.html 或 resume.HTML 就会 404——浏览器找不到入口文件。
常见错误现象包括：页面空白、CSS 不加载、链接跳转失败。根源不是代码错，是路径解析失败。
- 正确命名：
index.html、style.css、resume.js - 错误命名：
Index.HTML、my resume.html、简历.html、style.CSS - 如果用到图片，也一样：
avatar.jpg✅，Avatar.JPG❌
CSS 和 JS 文件名要和 link / script 标签里写的完全一致
HTML 中引用资源时，路径是字符串字面量，大小写、拼写、扩展名都必须逐字符匹配。哪怕只差一个字母，浏览器就当它不存在。
比如你在 index.html 里写了：
立即学习“前端免费学习笔记（深入）”；
<link rel="stylesheet" href="Style.css">
但实际文件叫 style.css，那样式就彻底失效，页面变纯文本。
- 检查方式：右键网页 → “查看页面源代码” → 点开
href或src对应的链接，看是否返回 404 - 编辑器里开启“显示隐藏字符”，确认没多余空格或不可见 Unicode 字符
- VS Code 用户可装插件
Path Autocomplete，自动补全时就强制小写+无空格
多版本简历用日期前缀，别用下划线或版本号后缀
投不同岗位需要微调内容，保留历史版本很重要。但 resume_v2_final_202610.html 这类名字容易误点、难排序、Git 提交记录混乱。
推荐用 ISO 8601 格式日期前缀，自然排序 + 一眼可知时效：
- ✅
20261015-resume-front-end.html - ✅
20261018-resume-product-design.html - ❌
resume-frontend-v2.html（v2 含义模糊，无法判断时间） - ❌
resume_frontend_2026_10_18.html（下划线多，日期格式不统一，排序错乱）
Git commit 信息也同步写清楚用途，比如：chore: update 20261015-resume-front-end.html for React role
部署到 GitHub Pages 时，index.html 必须放在仓库根目录
GitHub Pages 默认只认根目录下的 index.html 为首页。如果你把它放进 /src/ 或 /dist/ 子目录，即使路径写对了，访问 username.github.io/repo 也会显示 404 或目录列表。
- 正确结构：
your-repo/index.html、your-repo/style.css - 错误结构：
your-repo/src/index.html（除非你手动配置gh-pages分支或使用 Actions 部署） - 若想用子路径（如
username.github.io/resume），必须把整个项目推到username.github.io/resume仓库，且仍需根目录有index.html
最容易被忽略的一点：改完文件名后，别忘了同步更新所有引用它的地方——尤其是 <base href="/>%E3%80%81%E9%87%8D%E5%AE%9A%E5%90%91%E9%85%8D%E7%BD%AE%E3%80%81%E7%94%9A%E8%87%B3%E4%BD%A0%E5%8F%91%E7%BB%99%20HR%20%E7%9A%84%E9%93%BE%E6%8E%A5%E6%9C%AC%E8%BA%AB%E3%80%82
