直接访问本地HTML文件报404是伪错误，因file://协议不走HTTP服务器；应启用Live Server等本地服务，访问http://localhost:5500/index.html，并检查路径无中文空格、配置DocumentRoot/index、Network面板请求URL及文件权限与扩展名。
直接访问本地HTML文件却报404？别用file://
浏览器地址栏显示 file:///path/to/index.html 时出现“404 Not Found”，这其实是个伪404——HTTP协议根本没参与，服务器压根没启动。真正的问题是：你没走HTTP服务，却指望它返回HTTP状态码。
这类报错常见于初学前端者双击打开HTML文件，或VS Code Live Server插件未启用。解决方法非常明确：
- 关闭当前
file://页面，改用本地开发服务器访问，例如：http://localhost:5500/index.html（Live Server默认端口） - 确认服务器进程正在运行：终端执行
ps aux | grep -i "python -m http.server\|live-server\|npx serve"查看有无对应进程 - 避免在路径中使用中文、空格或特殊符号，比如
C:\my project\index.html容易被某些工具截断，换成C:\my_project\index.html
Apache/Nginx返回404？先查DocumentRoot和DirectoryIndex
当 http://localhost/index.html 明明存在却报404，大概率是Web服务器配置没对上。Apache和Nginx不会自动猜你把文件放哪了，必须靠 DocumentRoot 指明根目录位置。
典型错误场景包括：XAMPP的htdocs目录被误设为 D:/www，但你把文件放到了 D:/projects/my-site；或者Nginx配置漏写了 index.html 在 index 指令里，导致访问 / 时找不到默认页。
立即学习“前端免费学习笔记（深入）”；
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- Apache：检查
httpd.conf中DocumentRoot "/path/to/your/site"和<ifmodule dir_module> DirectoryIndex index.html </ifmodule> - Nginx：检查
server块内是否有root /path/to/your/site;和index index.html; - 改完配置必须重启服务：
sudo apachectl restart或sudo nginx -s reload，否则修改不生效
Network面板里看到404？盯住Request URL和Status列
页面加载后部分资源（如CSS、JS、图片）报404，但HTML本身能打开——这种“局部404”基本锁定为相对路径写错。浏览器开发者工具的 Network 面板是唯一可信信源，不要凭感觉猜。
关键动作是点开那个标红的请求，看 Request URL 到底拼成了什么。常见陷阱包括：
-
<link rel="stylesheet" href="css/style.css">放在/pages/about.html里，实际请求的是/pages/css/style.css（而非根目录下的/css/style.css） - Vue/React单页应用中，
vue-router的history模式未配Nginx重写规则，刷新/user/123页面直接404 - 静态资源引用用了绝对路径但漏了前导斜杠，比如
href="img/logo.png"应为href="/img/logo.png"
403 Forbidden混成404？检查文件权限和扩展名
有些系统（尤其是Linux/macOS部署）会出现“明明路径对、文件在、配置也没错，却报404”的情况。这时候要怀疑是不是服务器因权限拒绝读取，悄悄 fallback 成了404——特别是当你看到日志里有 Permission denied 却页面只显示404时。
另一个高频坑是Windows下文件扩展名隐藏：你看到 index.html，实际可能是 index.html.txt。服务器按真实扩展名找文件，自然找不到。
- Linux/macOS：执行
ls -l /path/to/index.html确认文件可读（-rw-r--r--），必要时chmod 644 index.html - Windows：打开文件夹选项 → 勾选“文件扩展名”，确认HTML文件后缀确实是
.html而非.html.txt - Apache若启用了
mod_security或自定义规则，也可能拦截请求并返回404而非403，需查error.log排除
404真正的麻烦不在“找不到”，而在“你以为找到了”。最常被跳过的一步是：不看Network面板的真实请求路径，只盯着代码里写的路径自我安慰。多一秒钟确认浏览器发出去的URL，能省掉半小时瞎调。
