先说点儿背景，GitHub Actions 是啥玩意儿

说实话，这玩意儿一出现，我就忍不住笑出声。

它其实就是 GitHub 官方给我们准备的 CI/CD 小工具。

你把代码推送上去，它就Neng帮你跑测试、打包、甚至部署。

听起来高大上，但其实上手超简单，跟装个插件差不多。

第一步：在仓库里建个工作流文件夹

打开你的 repo，根目录下新建 .github/workflows 目录。

Ru果Yi经有了那就直接往里加文件吧。

文件名随意，后缀一定要是 .yml 或 .yaml。

比如叫 ci.yml，里面写点配置，保存提交。

第二步：写个Zui基础的 workflow

下面这个例子干了两件事：拉代码、跑单元测试。

name: 简单 CI
on:
  push:
    branches: 
  pull_request:
    branches: 
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: 安装依赖
        run: npm install
      - name: 运行测试
        run: npm test

别忘了把 npm test 换成你自己的测试命令。

保存后去 GitHub 那边的 Actions 标签页，你会kan到刚才的 workflow 正在跑。

第三步：用现成的 Action 而不是自己写脚本

GitHub Marketplace 那里有海量别人写好的 Action。

比如想要自动发布到 npm，只要引用 actions/setup-node@v3 再配个 token 就行啦。

不对不对，应该是先把 token 放进 Settings → Secrets，再在 workflow 用 ${{ secrets.NPM_TOKEN }} 调用。

常见坑 & 小技巧

#1 环境变量泄露：别把私钥直接写进 yml，放 Secrets 才安全。

#2 缓存失效：Ru果构建慢，Ke以加个缓存步骤，用 @actions/cache 把 node_modules 缓存下来。

#3 步骤顺序：每一步dou是线性的，上一步失败后默认会中止后面的执行。想继续Ke以加 If: always.

"为什么百度不收录"？这跟 GitHub Actions 有啥关系？

哈哈，这问题常被问到，其实跟我们写 workflow 没太大关联，但顺便聊聊吧。

答案：

页面内容缺乏有效的 meta 信息或 robots.txt 阻止抓取；

Baidu 的爬虫频率受限，Ru果服务器响应慢也会被忽略；

Lack of inbound links – 没有其他站点链接到你的页面百度hen难发现它。

A站点结构混乱，URL 参数太多导致搜索引擎难以归类。

所以要想让百度收录，就得优化 SEO 基础：标题明确、描述合理、链接健康。别忘了在 GitHub Pages 上也Zuo好这些，否则再好的 Action 也帮不了忙呀！你懂的～

Hello World！让 CI 自动化跑起来的完整示例

name: CI Demo
on:
  push:
    branches:
      - main
      - develop
  pull_request:
jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v3
      - name: 设置 Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '20'
      - name: 安装依赖并缓存
        uses: actions/cache@v4
        with:
          path: ~/.npm
          key: ${{ runner.os }}-node-${{ hashFiles }}
          restore-keys: |
            ${{ runner.os }}-node-
      - run: npm ci
      - name: 单元测试 🧪
        run: npm test
      - name: 打包产物 
        if: success
        run: npm run build
      - name: 上传制品到 GitHub Release 
        if: github.ref == 'refs/heads/main' && success
        uses: softprops/action-gh-release@v1
        with:
          tag_name: v${{ github.run_number }}
          name: 自动发布 # 自动生成标签名和发布名
          files: dist/*.zip
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

小彩蛋：调试技巧 & 快速迭代方法

# 查kan日志： 点击每一次运行记录里的 “Run” 按钮，就Nengkan到每一步输出的日志。遇到错误时把关键命令单独跑一遍，kan是哪块炸了。哈哈，有时候报错信息kan着像外星文，只要抓住关键字搜索，一般douNeng找到答案。

# 使用 matrix 并行跑多个环境： Ru果你的项目需要在不同 Node 或 Python 版本下测试，只要在 jobs 下加一个 matrix 配置，就Neng一次性并行执行，多省事！比如：

strategy:
  matrix:
    node-version: 
run-ons-on:${{ matrix.node-version }}
...

# 手动触发工作流： 想临时跑一下？在 workflow 文件里加一个 `workflow_dispatch:` 就Ke以在 GitHub UI 上点按钮手动启动。超方便，用来验证新写的 action 时常用这个功Neng。说实话，我经常就是先手动跑一次再推正式分支。

# 定时任务: Ru果你想每天凌晨检查依赖安全性，Ke以这么写：

on:
  schedule:
    - cron: '0 2 * * *'
...

# 使用自定义 Docker 镜像： 有些项目需要特定工具链，用官方提供的 runner 不够。此时Ke以把整个环境封装成 Docker 镜像，然后在 `container:` 字段指定镜像路径。这样每次跑dou是同样的环境，不会因为系统升级而出奇怪的问题。不对不对，是 container 而不是 runs-on.

# 多仓库同步: Ru果公司还有内部代码平台，需要保持两个仓库同步，Ke以直接使用社区提供的 `wearerequired/git-mirror-action`。只要配置好 SSH 私钥和目标地址，一键搞定！我以前用了三次dou没出问题，真的省心啊~

# 输出变量给后续 Job 使用： 有时候你需要把前面 Job 的结果传递给后面的 Job，比如构建产物的 SHA 值。这时候Ke以用 `outputs:` + `${{ steps.xxx.outputs.xxx }}` 的方式共享数据。记得每个 step 要 `id:` 标识，否则拿不到值哦！

# 捕获错误继续执行： 默认情况下一旦某步报错就会终止整个 Job。Ru果你想让它继续往下走，比如即使测试失败仍然要上传报告，Ke以给那一步加 `continue-on-error:true`。不过慎用呀，这招容易掩盖真正的问题。

# 用 secret 管理敏感信息： 所有密码、token dou放在 Settings → Secrets 裏面然后在 yml 用 `${{ secrets.YOUR_NAME }}` 引用。千万别硬编码进代码，否则泄露风险大大滴！

# 本地调试 action： 想先本地跑一下自定义 Action 是否正常？Ke以把它当普通脚本执行，也Ke以使用 `act` 工具模拟 GitHub 环境。本地调通再提交，上线geng稳妥啊！

# 学会阅读官方文档： 官方文档里列了所有 event、context、表达式等细节。我一般只挑自己需要的章节kan，别像机器人一样逐字背诵，那样只会头疼。哈哈，有时候文档geng新快，你得及时关注 Release Notes 哦~

# 社区资源大宝藏： GitHub Marketplace + Awesome-Actions 列表里几乎dou有现成实现，你只要挑一个 star 多、geng新活跃的就行。不对不对，是挑维护者活跃且文档齐全的，那才靠谱！

# 注意配额与费用： 免费用户每月有一定分钟数和存储空间，Ru果频繁跑大型作业可Neng会超额。监控一下 Usage 页面Ru果快到上限，就考虑精简步骤或迁移到自托管 Runner 上。

A 小结：从零到一套 CI/CD 流程，只需三步走！

- 创建 .github/workflows 文件夹 📂

- 写一个简易 yml 配置 🎉

- 推送代码，kan Actions 自动运行 🚀

- 根据需求逐渐加入缓存、矩阵、多仓库同步等高级特性 🌟

- 持续迭代，不断优化速度与可靠性 🍻

Zui后一句话:

赶紧打开你的仓库，加上一条 workflow，让 CI 为你省掉手动敲命令的时间吧！哈哈，不管是新手还是老鸟，douNeng从这套模板起飞，实现“写完代码自动测”“合并主分支自动发布”。懂了吗？懂了就去试试呗~ Ru果卡住了就回来kan这篇文章——咱们一起啰嗦解决问题呀~ 🙌🏽️​

---