直接打开 file:/// 路径不会触发 404，真出现 404 说明正通过 Web 服务器访问而文件未在配置根目录中；需检查协议、路径、服务器配置及 Network 面板请求 URL。
直接打开 file:/// 路径的 HTML 文件不会触发 404，真出现 404 说明你正在用 Web 服务器（如 Nginx、Apache、Tomcat、IIS 或本地开发服务器）访问它，而服务器找不到那个文件——问题不在 HTML 本身，而在路径、配置或部署环节。
检查浏览器地址栏是不是 file:// 协议
这是最常被忽略的第一步。如果你双击 HTML 文件或右键“在浏览器中打开”，地址栏显示的是 file:///xxx/index.html，那根本不会有 404 错误（HTTP 状态码只存在于 HTTP/HTTPS 请求中）。此时若看到“404”，实际是浏览器因安全策略拒绝加载资源（比如 iframe 或图片），表现为类似 404 的空白或报错提示。
- ✅ 正确做法：启动本地服务器，用
http://localhost:8080/index.html这类地址访问 - ❌ 错误认知：以为“本地测试就该双击打开”，结果卡在
file://下的跨域/路径解析限制里 - ⚠️ 特别注意：
iframe的src在file://下几乎必然失败，不是路径写错了，是浏览器直接禁掉
确认文件是否真的在服务器能访问到的路径下
Web 服务器只服务它配置的根目录（DocumentRoot、root、webapps/ 或 public/）里的文件。放错位置 = 一定 404。
- Apache/Nginx：检查配置中的
DocumentRoot或root指向哪，HTML 文件必须在那个目录（或其子目录）内 - Tomcat：HTML 必须放在某个已部署 Web 应用的根目录下，例如
webapps/myapp/index.html，访问地址是http://localhost:8080/myapp/index.html - IIS / SiteAzure：注意
<location></location>配置可能限制了哪些目录允许处理.html，比如upload/目录默认被拦截，需手动加<location path="upload"></location>块放开 - 开发服务器（Vite、Webpack Dev Server）：默认只托管
index.html所在目录及子目录；若 HTML 在dist/pages/test.html，但入口是dist/index.html，则不能直接访问/pages/test.html，除非配了historyApiFallback或静态路由
用浏览器 Network 面板看清楚到底请求了哪个 URL
不要猜路径，直接看浏览器发出去的请求地址和返回的状态码。打开开发者工具 → Network → 刷新页面 → 找到状态为 404 的那一行，点开看 Headers 里的 Request URL。
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
- 如果 URL 是
http://localhost:3000/img/logo.png但你实际把图片放在了assets/logo.png，那就改<img src="assets/logo.png"> - 如果 URL 是
http://localhost/upload/report.html，但服务器配置的根目录是/var/www/html，那你得把文件放到/var/www/html/upload/report.html，而不是桌面或项目根目录 - Linux 服务器上注意大小写：
Report.html≠report.html；Windows 下不报错，一上生产就 404 - Windows 记得关掉“隐藏已知文件扩展名”——你看到的
index.html实际可能是index.html.txt
验证服务器是否真返回了 404 状态码（而非 200）
有些团队把 404.html 放在根目录，Nginx 配了 error_page 404 /404.html，结果页面能显示，但响应头是 200 OK。这会让搜索引擎持续抓死链，是严重 SEO 事故。
- 用
curl -I http://localhost/nonexistent查响应头，必须看到HTTP/1.1 404 Not Found - Nginx 正确写法：在
location = /404.html块里加internal;，否则外部可直连，破坏状态码继承 - Spring Boot 静态错误页失效？删掉
static/404.html，把文件移到templates/error/404.html，并确保spring.mvc.throw-exception-if-no-handler-found=true
真正卡住人的往往不是“怎么配”，而是没意识到：服务器看不到你认为它该看到的路径，浏览器 Network 里那个红色 404 请求 URL，就是唯一真相。先盯住它，再动手改路径或配置，别在文件管理器里凭感觉拖来拖去。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
