使用Quarto搭建的数据科学作品集在GitHub Pages和Netlify部署均现Error 404

下面是针对你遇到的问题的具体排查和修复方案：

1. 核对Quarto输出目录配置 #

Quarto默认将渲染后的静态文件输出到_site目录，若你的_quarto.yml修改过输出路径，部署时必须对应指定。打开_quarto.yml检查：

project:
  output-dir: "_site"

如果这里设置的是其他目录（比如docs），后续部署步骤里的目录配置要和它保持一致。

2. GitHub Pages部署的分支与目录校验 #

• 进入GitHub仓库的「Settings」→「Pages」页面，确认选择的分支和目录正确：
  • 若用Quarto自动发布，直接在RStudio运行命令生成并推送gh-pages分支：

    quarto::quarto_publish_site(server = "github")
    

  • 若手动推送，要把_site下的所有文件推送到gh-pages分支，或者将输出目录设为docs并选择主分支的/docs目录作为发布源。
• 注意GitHub Pages生效可能有延迟，设置完成后等待5-10分钟再访问。

3. Netlify的发布目录与构建命令配置 #

• 在Netlify站点的「Build & deploy」→「Build settings」中，把「Publish directory」设为Quarto的输出目录（默认_site）。
• 确认Build命令设置为quarto render，确保Netlify构建时能生成完整的静态文件。

4. 检查首页文件是否存在 #

从你的文件截图看，要确保项目根目录有index.qmd文件，渲染后输出目录会生成index.html——这是平台默认识别的首页。如果首页文件名不是index，需要在_quarto.yml里指定：

website:
  home: index.qmd

5. 确认静态文件已被推送 #

检查.gitignore文件，若里面有_site（或你的输出目录）的忽略规则，要删掉这一行，确保渲染后的静态文件能被推送到GitHub仓库，Netlify才能拉取到完整的站点文件。

内容的提问来源于stack exchange，提问作者VINCENT JEDI