部署成功，首页却 404：检查输出目录

01先把现象说准确

第一次部署后，Pages 显示完成，但直接访问网站根路径却得到 404。继续尝试时发现，加上 /public/ 可以看到页面。这两个现象放在一起，比“网站打不开”提供了更多线索：文件可能已经上传，只是没有位于预期的入口。

这时没有必要立刻更换域名或重新创建项目。先记录访问地址、返回结果和仓库结构，再看平台究竟上传了哪个文件夹。部署流程成功执行，与首页文件放在正确位置，是两个需要分别验证的条件。

02仓库根目录不等于网站根目录

本站的首页位于仓库的 public/index.html。如果把整个仓库当作网站内容发布，访问者看到的目录关系也会多出 public 这一层。于是根路径没有对应的首页，而 /public/ 能找到文件。

输出目录的作用，是告诉 Pages 从哪里收集最终网站内容。把它设为 public 后，这个文件夹里的 index.html 就成为网站入口，style.css 也跟着位于同一层。浏览器访问地址不需要再带上仓库中的 public 文件夹名。

仓库文件：public/index.html
输出目录：public
网站入口：/

仓库文件：public/style.css
网站地址：/style.css

03静态页面需要的几项设置

这份最初的 HTML/CSS 项目没有构建过程。本站采用的配置是框架预设 None、构建命令 exit 0、输出目录 public，根目录留空。exit 0 在这里表示命令成功结束，并不会把源文件转换成另一套页面。

这些值取决于项目结构，不能机械套用到所有网站。根目录决定平台从哪里开始处理项目，输出目录决定最终发布哪些文件。如果以后使用生成器，应重新核对它实际产生页面的位置，而不是沿用旧值猜测。

04用一次重新部署验证判断

保存配置并重新部署后，先检查 Pages 提供的地址，再检查独立域名。除了首页，也要打开样式文件和图片：页面能返回内容，但 CSS 路径错误，同样会让结果看起来像“没有部署好”。

这次问题的修复验证了输出目录的判断，但不是所有 404 都来自这里。文件名大小写、链接路径和部署版本都值得逐项检查。每次只根据已有证据改一个环节，再验证原本失败的地址，排错过程会更可控。

修复后也值得把正确配置记到项目说明里，连同文件夹结构一起保存。下次迁移或重建项目时，能直接对照这份记录，而不用再猜每个输入框的含义。

• 确认输出目录中直接存在 index.html
• 确认当前部署对应预期的提交
• 验证首页、样式和图片各自的访问结果