html文件应放在项目根目录或public/子目录下，netlify会自动识别index.html为入口；拖拽上传适合临时演示，git连接支持自动部署与回滚；404常见原因包括相对路径错误、缺失index.html及域名未验证；简单站点无需netlify.toml，spa路由、https强制和缓存需配置。
HTML 文件放哪？直接扔根目录就行
Netlify 托管纯 HTML 网站，本质就是托管静态文件。它不运行服务器、不解析 PHP 或 Node.js，只负责把你的 index.html 和相关资源（style.css、script.js、图片等）原样发给浏览器。
- 文件结构只要保证
index.html在项目根目录或public/子目录里，Netlify 就能自动识别为入口 - 不用写构建脚本，不用配
netlify.toml（除非你有重定向或 headers 需求） - 常见错误：把
index.html放在src/或dist/html/深层路径下却不告诉 Netlify 输出目录——结果部署成功但 404
拖拽上传 or Git 连接？选哪个更稳
两种方式都能用，但行为差异明显：
- 拖拽上传适合临时演示、单页小项目，上传后立刻可访问，但没版本记录、没法自动更新
- Git 连接（GitHub / GitLab / Bitbucket）才是生产级做法：每次 push 自动触发重新部署，还能回滚到任意 commit
- 容易踩的坑：
main分支名在新仓库默认是main，但旧项目可能是master；Netlify 默认拉main，如果没改对分支，会部署空页面或旧版 - 另一个坑：Git 忽略了
.html文件（比如误配了.gitignore），导致上传后只有空目录
为什么点开是 404？检查这三处
纯 HTML 部署后常见 404，往往不是 Netlify 的问题，而是路径或配置出错：
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 相对路径写死：比如
href="pages/about.html"，但实际文件在根目录，应改为href="about.html"；Netlify 不做路由重写，路径必须严格匹配文件系统 - 缺少
index.html：Netlify 默认只找根目录下的index.html，不会尝试home.html或default.html - 自定义域名没验证：绑了
www.yoursite.com却没在 DNS 添加 CNAME 记录，或没在 Netlify 控制台点击「Verify domain」，状态卡在 pending，访问时可能跳转失败或显示 Netlify 默认页
要不要配 netlify.toml？简单需求不用，但这些情况得加
90% 的纯 HTML 站点完全不需要配置文件。但遇到下面场景，加几行就解决：
- 需要 SPA 路由 fallback（比如用
history.pushState的单页应用）：[[[redirects]]<br> from = "/*"<br> to = "/index.html"<br> status = 200]
- 想让所有请求走 HTTPS：
[[headers]]<br> for = "/*"<br> [headers.values]<br> Strict-Transport-Security = "max-age=31536000; includeSubDomains; preload"
- 静态资源加缓存头，避免重复下载：
[[headers]]<br> for = "/assets/*"<br> [headers.values]<br> Cache-Control = "public, max-age=31536000, immutable"
路径和重定向规则大小写敏感，from = "/About.html" 和 /about.html 是两个不同规则。
Netlify 对纯 HTML 的支持很直接，但它的“零配置”背后藏着对路径、Git 状态和静态语义的强依赖。最容易被忽略的，其实是本地测试时用双击打开 index.html（file:// 协议），和上线后通过 HTTP 协议访问之间的行为差异——比如相对路径解析、跨域限制、Service Worker 注册失败，这些在本地完全看不出来。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
