如何移除部署在GitHub Pages的Docusaurus站点的baseUrl

核心原因 #

你之前改baseUrl为/后样式丢失，是因为当前站点部署在GitHub项目页面（仓库名catallactic-site），这类页面默认会被托管在https://<org>.github.io/<repo-name>/路径下，静态资源的实际位置也在这个子路径里。当你把baseUrl设为/，Docusaurus会从根域名请求资源，自然找不到，导致样式加载失败。

实现根域名访问的正确步骤 #

GitHub Pages的根域名（https://Catallactic.github.io/）只能对应一个名为Catallactic.github.io的组织/用户仓库，你需要按以下步骤调整：

1. 创建或迁移到指定仓库

   • 在GitHub上创建名为Catallactic.github.io的仓库（名字必须完全匹配组织名，大小写一致）
   • 将当前Docusaurus站点的代码迁移到这个新仓库，或直接修改原有仓库的名称为Catallactic.github.io

2. 修改Docusaurus配置文件docusaurus.config.js
   更新以下配置项：

   const config = {
     // ...其他原有配置
     url: 'https://catallactic.github.io',
     baseUrl: '/', // 根域名访问时设为斜杠
     trailingSlash: true, // GitHub Pages根站点建议设为true，避免路径跳转异常
     // GitHub Pages配置更新
     organizationName: 'Catallactic',
     projectName: 'catallactic.github.io', // 对应新的仓库名称
     // ...其他原有配置
   }
   

3. 调整部署设置

   • GitHub Pages对于Catallactic.github.io仓库，默认会从main（或master）分支的根目录部署内容
   • 如果之前用docusaurus deploy命令部署，需确保构建产物推送到新仓库的对应分支：要么在GitHub仓库设置里把部署来源改成gh-pages分支，要么调整部署命令的目标分支为main

关于GitHub Pages是否必须用baseUrl #

不是必须的：

• 部署组织/用户根站点（对应<org>.github.io仓库）时，baseUrl必须设为/，无需子路径
• 部署普通项目站点（非<org>.github.io仓库）时，baseUrl必须设为/<repo-name>/，否则会出现资源加载失败的问题

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