直接扔到服务器根目录就能访问？需确认静态托管环境，确保 index.html 置于域名指向的根目录，所有资源引用基于其位置解析，推荐使用根相对路径（如 /css/style.css）并用本地 HTTP 服务测试。
直接扔到服务器根目录就能访问？先确认你用的是静态托管还是动态环境
绝大多数 HTML5 网站（纯 index.html + css/ + js/ + 图片）不需要 后端，走静态托管最省事。但很多人卡在第一步：把文件传上去却 404，或图片路径全错——根本原因是没理清「相对路径的基准」。
-
index.html必须放在目标域名指向的根目录下（比如 Nginx 的/usr/share/nginx/html/，或 GitHub Pages 的gh-pages分支根） - 所有内部链接（
）、资源引用（）都基于index.html所在位置解析，不是基于你本地编辑器打开的路径 - 如果网站有子页面（如
products.html在/pages/下），而它又引用了../css/style.css，那部署时必须保持/pages/目录结构完整，不能只传单个文件
GitHub Pages 发布多页网站：别只推 main 分支，注意发布源设置
GitHub Pages 是零成本发布 HTML5 网站最常用的方式，但多人踩坑在「发布源」选错分支或文件夹。它不自动识别 index.html 位置，而是严格按你配置的路径找入口文件。
- 进仓库 Settings → Pages → Source，选
Deploy from a branch - 若整个网站就一个
index.html和配套资源，选main分支 +/(root) - 若你把所有网页放进
docs/文件夹（比如 Jekyll 默认输出），就选main分支 +/docs—— 否则 GitHub 会去根目录找index.html，找不到就显示 404 - 确保
index.html存在于所选路径下；子页面如contact.html要和它同级（或按相对路径正确嵌套），否则链接点击后 404
本地测试没问题，上线后 CSS/JS 不加载？检查 浏览器 控制台的 404 请求路径
这是多页面 HTML5 网站上线后最高频的问题。原因几乎全是路径写死或混淆了开发与生产环境的目录层级。
- 打开浏览器开发者 工具（F12），切到 Network 标签页，刷新页面，看哪些
.css或.js显示红色 404 - 点开那个失败请求，看「Initiator」列或「Headers」里的 Request URL，对比你代码里写的路径（比如
）是否真对应服务器上的物理路径 - 常见错误：
index.html在根目录，但about.html在/pages/下，而它仍写—— 实际应写或统一用根相对路径 - 推荐做法：所有资源引用统一用根相对路径（以
/开头），例如/css/style.css、/images/logo.png，这样无论页面在哪一级目录都能准确定位
想支持 URL 路由（如 /blog/post-1）但不用服务端？得配服务器重写或用 hash 模式
纯静态 HTML5 网站默认不支持真正的路径路由（即没有 post-1.html 文件却能访问 /blog/post-1）。前端 框架常靠 History API 实现，但部署时需配合服务器配置，否则刷新页面就 404。
立即学习 “ 前端免费学习笔记（深入）”；
- 最简单绕过法：用 hash 路由，URL 形如
example.com/#/blog/post-1，无需任何服务器配置，window.location.hash可读取，且刷新不会丢 - 要用真实路径（History 模式），Nginx 需加配置：
location / {
try_files $uri $uri/ /index.html;
}这样所有未匹配静态文件的请求，都会 fallback 到
index.html，由前端路由接管 - GitHub Pages 不支持自定义服务器重写，所以 History 模式在它上面行不通；必须用 hash 模式，或换 Vercel/Netlify 这类支持 _redirects 文件的平台
多页面 HTML5 网站发布本身不难，难在路径逻辑一旦错一层，整个导航或样式就断掉。别依赖本地双击打开测试，每次改完路径，务必用本地 HTTP 服务（如 npx serve 或 VS Code Live Server）模拟真实请求路径再验证。
