真实URL需在Network面板中查看Request URL字段,逐字符比对服务器文件路径,尤其注意Linux系统大小写敏感问题。

直接看 Network 面板里请求的真实 URL
浏览器不关心你“觉得”路径应该是什么,只按规则拼出一个真实请求地址。打开开发者工具(F12)→ 切到 Network 标签页 → 刷新页面 → 找到标红的 404 请求(比如 style.css 或 logo.png),点开它,看 Request URL 字段。这个地址就是服务器实际收到的请求——把它和你项目里真实文件路径逐字符比对,重点盯大小写。
Linux 服务器上大小写敏感是默认行为
Windows 和 macOS 本地文件系统默认不区分大小写,IMG/logo.PNG 和 img/logo.png 都能打开;但一部署到 Linux 服务器(Nginx/Apache/Tomcat),Logo.png ≠ logo.png,CSS/ ≠ css/,错一个字母就 404。
- 检查所有
src、href、data-src中的路径,确保大小写与磁盘上文件名完全一致 - 特别注意:Git 默认不追踪大小写变更,
git status可能显示“nothing to commit”,但文件已悄悄变成大写 - 用
ls -l在服务器上直接列出目录内容,确认真实大小写形态
VS Code 里怎么快速发现大小写问题
编辑器本身不报错,但可以辅助验证:
- 在
src或href值上右键 → “Go to Definition”:如果跳转失败,大概率是路径或大小写不对 - 启用
files.enableTrash关闭后,用系统命令行进项目根目录,执行find . -iname "logo.png"查所有匹配项,看实际存在的是哪个大小写变体 - 不要依赖缩略图或资源管理器预览——它们可能缓存旧状态;以终端
ls或 FTP 工具里看到的为准
本地开发时别双击打开 HTML 文件
file:// 协议下,浏览器对路径解析不一致,且完全绕过服务器的大小写校验逻辑,导致“本地能跑,上线就 404”。
立即学习“前端免费学习笔记(深入)”;
- 改用轻量服务启动:
npx serve、python3 -m http.server 8000或 VS Code 的 Live Server 插件 - 这样访问
http://localhost:8000/index.html,路径解析规则才和线上 Nginx/Apache 一致 - 尤其注意
<link href="/css/style.css">这种根路径:本地双击时浏览器可能忽略/,而服务模式下严格从域名根开始找
Request URL 和服务器 ls 输出逐字核对的习惯。



















