静态HTML模板上线核心是确保资源路径正确：CSS、JS、图片、字体等必须使用根目录相对路径（如/css/style.css），避免本地双击正常但托管后404；GitHub Pages需仓库名username.github.io且发布源设为根目录；Netlify/Vercel上传时勿填构建命令和输出目录，手动指定index.html为入口；自建服务器须配置DirectoryIndex及正确MIME类型。
直接扔到静态托管平台就能上线，但路径、资源引用和域名配置必须对
绝大多数 HTML 响应式模板（比如蓝色清新图书馆模板、教育类模板或 Bootstrap 企业官网）不依赖后端，本质是一堆 index.html、style.css、script.js 和图片文件。部署的核心不是“怎么传”，而是“传完能不能被正确加载”。常见失败不是服务器没开，而是浏览器控制台刷出一堆 404 —— 图片路径错、CSS 引用断、字体文件 404，全是因为本地开发时用的相对路径在上线后失效。
- 检查所有
<link rel="stylesheet">和<script src></script>的路径：如果本地双击打开能跑，但上传后样式丢失，大概率是用了../css/main.css这类向上跳级的写法；上线前统一改为根目录相对路径，如/css/main.css - 图片路径同理：
img/logo.png在子页面（如/about/index.html）里会变成/about/img/logo.png，应改用/img/logo.png - 确认
favicon.ico放在网站根目录，且<link rel="icon">指向的是/favicon.ico，不是./favicon.ico - 如果用了 Web 字体（如
fonts/inter.woff2），CSS 里的@font-face src: url(...)也得是根路径或相对于 CSS 文件的正确路径
GitHub Pages 部署最简路径：不用命令行也能做
GitHub Pages 是最轻量、零成本的静态托管选择，适合模板类项目快速验证。关键点不是“怎么 push”，而是仓库结构和发布源设置是否匹配模板预期。
- 新建公开仓库，名称格式为
username.github.io（否则默认只支持/docs子目录或gh-pages分支） - 把整个模板文件夹内容（含
index.html）直接拖进仓库根目录，不要套一层文件夹 - 进入 Settings → Pages → Source，选
Deploy from a branch，Branch 选main（或master），Folder 选/(root) - 保存后等 1–2 分钟，访问
https://username.github.io—— 如果看到首页但控制台仍有 404，回头查上面说的路径问题
Netlify / Vercel 部署更省心，但要注意构建设置陷阱
Netlify 和 Vercel 对纯静态站点更友好，自动识别 index.html，还能一键预览 PR、绑定自定义域名。但它们默认按“构建产物”逻辑处理，而模板往往没有 build 步骤，容易误配。
Wechat Article Html
下载
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
- 拖拽整个模板文件夹上传即可，无需配置构建命令（
npm run build等留空） - Public directory 填
.（当前根目录），不是dist或public—— 模板没经过打包，不存在这些目录 - 如果上传后返回 404 页面而非你的首页，说明 Netlify 把
index.html当成了普通文件，没设为入口；进 Site settings → Build & deploy → Static assets，手动指定index.html为入口页 - Vercel 同理：Project Settings → General → Output Directory 留空，别填任何路径
自建服务器或虚拟主机上线前，必须验证基础 HTTP 行为
很多老派虚拟主机（尤其是国内备案型）默认禁用目录索引，或强制重写规则，导致 index.html 不自动触发，或者 CSS 被当成下载文件而不是样式表。
立即学习“前端免费学习笔记（深入）”；
- 上传后先访问完整路径：
https://yoursite.com/index.html—— 如果能打开，说明文件已就位；再试https://yoursite.com/，若 404 则需在服务器上启用DirectoryIndex index.html（Apache）或index index.html;（Nginx） - 检查响应头：
Content-Type: text/css必须对应 CSS 文件，如果返回application/octet-stream，浏览器不会解析样式 —— 联系主机商添加 MIME 类型映射 - 部分共享主机禁止执行 JS 或限制外部字体加载，测试轮播图、表单验证是否真能运行，不能只看 HTML 结构
- 如果用了
srcset或懒加载loading="lazy"，某些老旧环境（如 Windows Server IIS 7）可能不识别，降级方案是保留src属性并用 JS 动态补srcset
真正卡住人的从来不是“怎么上传”，而是上传后资源加载链断裂——一个图片路径错，整页视觉崩；一个 viewport 标签被插件覆盖，移动端立刻缩成一团。上线前花三分钟扫一遍 Network 面板，比反复重传十次更有效。
