17370845950

github pages 默认区分文件路径大小写，若 html 中引用的 css 路径（如 `css/styles.css`）与实际文件夹名（如 `css/`）大小写不一致，将导致 404 错误。

当你将网站部署到 GitHub Pages 时，资源加载失败（尤其是 CSS、JS 或图片）是一个常见问题，其中路径大小写不匹配是高频原因。GitHub Pages 运行在 Linux 环境服务器上，而 Linux 文件系统严格区分大小写；但本地开发时（如 Windows 或 macOS 的默认设置），文件系统通常不区分大小写，因此在本地能正常加载，上传后却报 Failed to load resource: the server responded with a status of 404 ()。

以你的项目为例：

• GitHub 仓库中实际 CSS 文件夹名为 CSS/（全大写）；
• 但 HTML 文件中引用的是 （小写 css）；
• 服务器无法找到 css/styles.css，因为只有 CSS/styles.css 存在 → 返回 404。

✅ 正确做法是确保 HTML 中的路径与 GitHub 仓库中的实际目录名完全一致（包括大小写）：

? 额外检查建议：

• 在 GitHub 仓库网页端直接点击 CSS/styles.css，确认链接可访问且返回正确 CSS 内容；
• 检查浏览器开发者工具（F12 → Network 标签页），筛选 CSS 类型，观察请求 URL 和响应状态码；
• 避免混合使用相对路径与绝对路径：推荐统一使用相对于 HTML 文件的相对路径（如上例），或使用根相对路径（如 /CV/CSS/styles.css），但需注意 GitHub Pages 项目站点子路径（如 https://mojjo2016.github.io/CV/ 中 /CV/ 是子目录），此时若用根路径需包含子路径前缀（不推荐初学者使用，易出错）；
• 提交前可在本地用简易 HTTP 服务验证（如 npx serve 或 VS Code Live Server），模拟真实路径行为。

? 小结：GitHub Pages ≠ 本地开发环境。始终以 GitHub 仓库中可见的、精确的大小写路径为准编写资源引用。一次大小写修正，即可解决 90% 的静态资源 404 问题。