如何在Travis CI构建阶段中配置GitHub Pages部署？

我仔细看了你的配置文件，问题主要出在多阶段任务的环境隔离特性和deploy配置的语法结构上，下面给你拆解问题并给出修正后的可行方案：

问题根源分析 #

1. 任务环境不共享：Travis的每个stage对应的job都是在全新的独立环境中运行的，你在build阶段生成的public/目录，不会自动同步到deploy阶段的job里，这就导致部署时找不到要上传的文件，直接触发失败。
2. deploy配置位置错误：在多阶段配置模式下，deploy区块不能直接写在stage层级下，必须嵌套在jobs.include对应的具体job内部，否则Travis无法识别部署规则。

修正后的配置方案 #

最直接的解决方式是把构建和部署合并到同一个deploy阶段的job中，确保部署时构建产物存在，同时修正deploy的语法结构：

language: node_js
sudo: required
dist: trusty
# 跳过gh-pages分支的构建
except:
  - gh-pages
cache:
  directories:
    - node_modules
node_js:
  - "10"

# 定义构建阶段
stages:
  - build
  - test
  - release
  - deploy

jobs:
  include:
    # 构建阶段任务
    - stage: build
      node_js:
        - lts/*
      script:
        - npm run build
      branches:
        only:
          - release
          - dev
          - master

    # 测试阶段任务
    - stage: test
      node_js:
        - lts/*
      script:
        - npm run test
      branches:
        only:
          - release
          - dev
          - master

    # 版本发布阶段任务
    - stage: release
      node_js:
        - lts/*
      skip_cleanup: true
      script:
        - npx semantic-release
      branches:
        only:
          - master

    # GitHub Pages部署阶段任务
    - stage: deploy
      node_js:
        - lts/*
      script:
        - npm run styleguide:build # 在部署前重新执行构建，确保public目录存在
      deploy:
        provider: pages
        skip_cleanup: true
        github_token: $GH_TOKEN # 需在仓库Travis设置中配置该安全变量
        keep_history: true
        local_dir: public/
        on:
          branch: master

关键调整说明 #

• 将页面构建命令npm run styleguide:build移到了deploy阶段的job中，这样部署前会重新生成public/目录，完美解决跨job文件不共享的问题。
• 把deploy区块正确嵌套在deploy阶段的job内部，符合Travis多阶段配置的语法规范。
• 移除了全局的before_install和script配置，避免和job内的自定义脚本冲突（如果需要全局环境变量，可放在env.global区块中统一配置）。

如果不想重复执行构建，也可以通过Travis的缓存功能缓存public/目录，或者使用artifacts插件在job间传递构建产物，但重新构建是最简单高效的方案，适合大多数场景。

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