必须确保index.html位于项目根目录或public/子目录下，否则Netlify无法识别导致404；常见错误包括index.html置于src/等深层路径、ZIP压缩包嵌套文件夹、相对路径引用不匹配发布结构。
Netlify部署时找不到index.html怎么办
Netlify必须在发布目录里看到 index.html（或 404.html）才能识别为有效静态站点，否则会报“Page Not Found”或直接显示 Netlify 默认欢迎页。
- 检查压缩包或 Git 仓库根目录下是否真有
index.html—— HTTrack 下载后常把文件放在子文件夹里（比如mysite/），需要把里面的内容提到顶层 - Windows 用户注意：文件名大小写敏感性被忽略，但 Netlify 运行在 Linux 环境，
Index.html或INDEX.HTM都不会被识别 - 如果用的是构建工具（如 Astro、Jekyll），确认
publish路径指向的是生成后的目录（如dist/或_site/），而不是源码目录
手动上传 ZIP 包失败的常见原因
拖放 ZIP 部署看似简单，但实际容易卡在解压或路径解析环节，导致页面空白或 404。
- ZIP 必须是「扁平结构」：即
index.html直接在 ZIP 根层，不能嵌套在额外文件夹内（例如不要打包成my-site/my-site/index.html） - 避免隐藏文件或 macOS 的
.DS_Store：这些文件可能干扰 Netlify 解析，建议用zip -r site.zip * -x ".DS_Store"命令生成 - 上传后别急着关页面 —— Netlify 解压和检测需几秒，刷新太早会看到临时错误页；可看右上角部署状态图标是否变成绿色勾
用 Git 部署时 build 命令和 publish 目录怎么填
Netlify 能自动识别部分框架（如 Gatsby、Next.js），但对纯 HTML 项目或自定义构建流程，必须显式指定 command 和 publish。
- 纯静态站点（无构建步骤）：
command留空，publish填.（点号，表示根目录） - 使用 npm 构建（如
npm run build输出到dist/）：command填npm run build，publish填dist - 用 Jekyll：
command是jekyll build，publish是_site；用 Astro 则是astro build+dist - 所有路径都**不带前导斜杠**，
/dist是错的，dist才对
部署后资源 404 或样式丢失
这几乎全是路径问题，和 Netlify 本身无关，而是 HTML/CSS/JS 中引用的相对路径没对齐发布结构。
立即学习“前端免费学习笔记（深入）”；
- 检查所有
<link rel="stylesheet" href="css/style.css">这类路径 —— 如果你的 CSS 文件实际在assets/css/style.css，那 href 就得写成assets/css/style.css - 图片路径同理，
<img src="images/logo.png">要确保images/logo.png真的存在于 ZIP 或 Git 仓库中对应位置 - 避免绝对路径（如
/css/style.css），除非你设置了baseURL或 Netlify 的_redirects规则来兜底 - 打开浏览器开发者工具的 Network 标签页，看具体哪个文件返回 404，再反向定位路径错在哪一层
Netlify 对纯静态站点足够友好，但它的自动化建立在“约定优于配置”基础上——它不猜你想要什么，只严格按规则执行。最常出问题的地方不是部署操作本身，而是本地文件组织和路径引用这两个隐形环节。
