合并HTML后404主因是路径基准变化：相对路径（如../css/style.css）在新目录结构下越界失效；应统一改用根路径（/css/style.css）或扁平化后的./css/，并同步更新构建工具base配置、服务器错误页规则及iframe/fetch等动态引用。
合并多个HTML文件后报404，问题几乎从不发生在“合并动作”本身，而在于路径引用、资源定位和服务器上下文的断裂——index.html能打开，但里面引用的./css/main.css或pages/about.html突然失效，本质是相对路径基准变了，不是文件丢了。
合并后相对路径全部错位
原始多个HTML分散在不同目录（如/home.html、/pages/contact.html），各自用../css/style.css能正常加载；合并进一个dist/目录后，所有../都按新位置重新解析，上级目录可能已不存在。
- 打开开发者工具 → Network → 刷新，盯住标红请求的
Request URL，比如显示http://localhost/../css/style.css，说明浏览器试图向上越界，服务器直接拒绝 - 统一改用根相对路径：
href="/css/style.css"而非href="../css/style.css"，前提是你的服务根目录确实包含css/子目录 - 若合并后结构扁平化（所有HTML都在
dist/下），就别用../，全部改写为./css/或css/，并确认css/文件夹已复制到dist/同级 - 检查是否有硬编码的
<base href="...">，它会强制重写所有相对URL基准；合并后若<base>仍指向旧路径（如href="/old-site/"），所有资源都会404
构建工具导致的路径前缀丢失
用Vite、Webpack或Vue CLI合并时，常通过base或publicDir配置控制资源前缀。手动合并HTML却忘了同步更新这些路径，就会让<script src="assets/index.js"></script>实际请求http://localhost/assets/index.js，而文件其实在http://localhost/myapp/assets/index.js。
- Vite用户：确认
vite.config.ts中base: "/myapp/"，且HTML中所有资源路径都自动加了该前缀；若手动合并，需把src="index.js"改为src="/myapp/index.js" - Webpack用户：检查
output.publicPath是否与部署路径一致；若设为"auto"，本地file://测试会出错，必须走http://localhost - 静态托管平台（如GitHub Pages）要求
base与仓库名严格匹配：仓库叫my-project，base就得是"/my-project/"，否则/css/请求全404
合并后404.html不生效
你放了dist/404.html，但访问/nonexistent仍返回空白页或200，说明服务器根本没接管这个错误路径——合并操作没动服务器配置，但路径结构变了，原有error_page规则可能失效。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
立即学习“前端免费学习笔记（深入）”；
- Nginx用户：确认
error_page 404 /404.html;中的/404.html是绝对路径（以root为起点），且location = /404.html { internal; }已存在，否则外部可直连，状态码变成200 - Apache用户：检查
.htaccess是否随HTML一起复制到dist/，且含ErrorDocument 404 /404.html；若dist/不是DocumentRoot，这条指令不会生效 - GitHub Pages用户：
404.html必须放在Git仓库**根目录**，不能在dist/404.html；合并后若整个站点放在dist/里，就得把dist/内容推到仓库根，而不是推dist文件夹本身 - 用
curl -I http://localhost/nonexistent-path验证响应头，必须看到HTTP/1.1 404 Not Found，否则配置无效
iframe或动态加载内容触发404
合并HTML时可能保留了<iframe src="./report.html">这类标签，但report.html没被一并移入目标目录，或路径层级被拉平后，./不再指向原意。
- iframe的
src不要用./或../：改用绝对路径src="/report.html"，确保以站点根为起点 - 若
report.html是独立页面且未合并进来，要么补上它，要么改用src="https://example.com/report.html"外链 - JavaScript动态加载HTML（如
fetch('./data.html')）同样受路径影响；合并后应统一改为fetch('/data.html')或完整URL - 避免在合并后的HTML里留着
file:///或../这种本地开发残留路径，它们上线必炸
最易被忽略的一点：合并操作本身不改服务器行为，但会暴露原本被目录隔离掩盖的路径问题。Network面板里的Request URL永远比你记忆中的路径更真实，别猜，只信它。
