404错误本质是服务器收到请求但找不到对应资源，需先确认文件是否真在服务器可访问路径下、url与物理路径一致，并排除file://协议直开、大小写错误、扩展名隐藏、配置未重启等常见原因。
检查文件是否真在请求路径下
浏览器报404，第一反应不是代码错了，而是服务器根本没看到那个HTML文件。你移动了文件，但没同步更新访问路径，或者压根没把文件放到Web服务器能读到的地方。
常见错误现象：http://localhost/test.html 报404，但你在文件管理器里明明看到 test.html 就在项目根目录；或者你在PyCharm里右键“Open in Browser”，结果弹出 file:/// 协议地址，这根本没走服务器，自然不触发任何路由逻辑。
- 确认你用的是
http://localhost/xxx.html，而不是file:///开头的本地路径 - 查清你的服务器根目录在哪：Apache 是
htdocs，Nginx 是/usr/share/nginx/html，Python 的http.server则是你启动命令所在目录 - 如果用 PyCharm，HTML 文件必须和
venv、static目录平级，放在web/或直接放在项目根下（不能塞进venv或static里）
验证 URL 路径与文件系统路径是否一致
移动 HTML 文件后，URL 路径必须跟着变。比如你把 pages/about.html 移到了 about/index.html，那原来访问 /pages/about.html 就会 404，必须改成 /about/index.html 或配好默认索引（如 DirectoryIndex index.html）。
容易踩的坑：
- Linux/macOS 下文件名大小写敏感：
About.html≠about.html，URL 写错一个字母就 404 - Windows 资源管理器默认隐藏扩展名，你可能误存为
index.html.txt，看着像 HTML，实际是文本文件 -
../在<iframe src="../xxx.html"></iframe>或<img src="../assets/logo.png">中，解析依据是当前 HTML 所在 URL，不是它在磁盘里的位置
检查服务器配置是否仍指向旧路径
如果你改过 DocumentRoot（Apache）、root（Nginx）或 Python 服务的启动目录，但没重启服务，那服务器还在找老地方——哪怕文件已移到新位置，也照样返回 404。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
实操建议：
- Apache：检查
httpd.conf或apache2.conf中的DocumentRoot "/path/to/old"，改成新路径后执行sudo apachectl restart - Nginx：检查
nginx.conf里server { root /path/to/old; }，改完运行sudo nginx -s reload - Python 简易服务器：
python3 -m http.server 8000启动时，当前终端所在目录就是根目录；换位置就得 cd 过去再启
用浏览器 Network 面板看真实请求路径
按 F12 → 切到 Network → 刷新页面 → 找状态码为 404 的那一行 → 点开看 Headers 里的 Request URL。这个地址，就是服务器真正收到的请求路径，也是你修复的唯一锚点。
例如显示请求的是 http://localhost/js/main.js，但你刚把 JS 移到了 assets/js/，那就得改 HTML 里的 <script src="assets/js/main.js"></script>，而不是瞎猜配置。
注意：Referrer 字段会告诉你哪个 HTML 文件发起了这个 404 请求，顺藤摸瓜就能定位是哪个页面的链接/资源路径没同步更新。
最常被忽略的一点：移动 HTML 文件后，所有引用它的其他页面（比如导航栏里的 <a href="old-page.html"></a>）、所有内嵌资源（<iframe src="report.html"></iframe>）、甚至服务端重定向规则（.htaccess 里的 RewriteRule），都得手动核对一遍。单改一个文件，不等于问题消失。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
