如何将开发仓库部署到组织的GitHub Pages（跨仓库部署）

我刚好配置过类似的场景，把组织的应用开发仓库部署到组织专属的organization.github.io仓库的master分支，下面是完整的实现方案：

1. 准备工作 #

首先你需要在GitHub上生成一个Personal Access Token（PAT），权限勾选repo（确保能读写目标仓库），然后登录Travis CI，找到你的organization/app仓库，进入「Settings」->「Environment Variables」，添加一个名为GITHUB_TOKEN的变量，值填你刚生成的PAT。

2. 完整的.travis.yml配置 #

把下面的配置放到你的organization/app仓库根目录，根据你的项目实际情况调整部分参数：

language: node_js
node_js:
  - "node" # 使用最新稳定版Node.js
install:
  - npm install # 安装项目依赖
script:
  - npm run build # 执行项目构建命令，需确保产物输出到指定目录
deploy:
  provider: pages
  skip_cleanup: true # 关键！禁止Travis清理构建产物
  github_token: $GITHUB_TOKEN # 引用Travis中配置的环境变量
  target_branch: master # 组织GitHub Pages要求的分支
  repo: organization/organization.github.io # 目标部署仓库的完整名称
  local_dir: dist # 替换成你的项目构建产物所在目录（比如build）
  on:
    branch: main # 触发部署的开发分支（根据你的实际分支调整，比如master）

3. 关键参数解释 #

• skip_cleanup: true：必须开启，否则Travis会在部署阶段自动清理所有构建生成的文件，导致部署空内容。
• repo: organization/organization.github.io：因为是跨仓库部署，必须明确指定目标仓库，默认情况下Travis只会部署到当前仓库。
• local_dir: dist：这里要和你项目package.json中build命令的输出目录一致，比如React项目通常是build，Vue项目是dist，别填错了！
• on: branch: main：设置只有当你的开发分支（比如main或master）有新提交时，才触发Travis的构建和部署流程。

4. 注意事项 #

• 确保organization/organization.github.io仓库已经创建，且仓库名称完全符合组织GitHub Pages的要求（必须是[组织名].github.io）。
• 生成PAT时只勾选必要的repo权限，避免过度授权带来安全风险。
• 首次配置后可以手动触发Travis构建，查看日志排查问题，如果部署失败，重点检查目录路径、Token权限是否正确。

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