|
| 1 | +GitHub Actions 生态非常丰富。针对 **Node.js, Python, Go, Rust, PowerShell (pwsh)** 这几个技术栈,我整理了一份目前(2024-2025年视角)最实用、维护最积极的 Actions 推荐清单。 |
| 2 | + |
| 3 | +我们将清单分为 **通用型** 和 **语言专用型** 两部分。 |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +### 🟢 1. 必装/通用型 (所有语言适用) |
| 8 | + |
| 9 | +无论你用什么语言,这些 Action 几乎是 CI/CD 流水线的标配: |
| 10 | + |
| 11 | +* **`actions/checkout`** |
| 12 | + * **作用:** 拉取代码。 |
| 13 | + * **点评:** 官方核心 Action,V4 版本是目前的标准。 |
| 14 | +* **`actions/cache`** |
| 15 | + * **作用:** 缓存依赖(node_modules, pip cache, cargo target 等),显著加速构建。 |
| 16 | + * **点评:** 必须掌握。注:现在很多 setup-xyz 的 Action 都内置了 cache 参数,可以简化配置。 |
| 17 | +* **`softprops/action-gh-release`** |
| 18 | + * **作用:** 自动发布 GitHub Release,上传二进制文件/制品。 |
| 19 | + * **点评:** 比官方的 `create-release` (已废弃) 更好用,支持多文件上传和 Changelog 生成。 |
| 20 | +* **`docker/build-push-action` & `docker/login-action`** |
| 21 | + * **作用:** 构建 Docker 镜像并推送到 DockerHub/GHCR。 |
| 22 | + * **点评:** 容器化部署的标配。 |
| 23 | +* **`codecov/codecov-action`** |
| 24 | + * **作用:** 上传测试覆盖率报告到 Codecov 平台。 |
| 25 | + * **点评:** 想要那个绿色的 "coverage 90%" 徽章吗?用它。 |
| 26 | + |
| 27 | +--- |
| 28 | + |
| 29 | +### 🟡 2. Node.js 开发者的瑞士军刀 |
| 30 | + |
| 31 | +Node.js 的依赖安装通常较慢,优化重点在于缓存。 |
| 32 | + |
| 33 | +* **`actions/setup-node`** |
| 34 | + * **实用技巧:** 使用 `cache` 参数自动处理 npm/yarn/pnpm 缓存,无需手写 `actions/cache`。 |
| 35 | + |
| 36 | + ```yaml |
| 37 | + - uses: actions/setup-node@v4 |
| 38 | + with: |
| 39 | + node-version: '20' |
| 40 | + cache: 'npm' # 或 'pnpm', 'yarn' |
| 41 | + ``` |
| 42 | +
|
| 43 | +* **`pnpm/action-setup`** |
| 44 | + * **作用:** 专门用于安装 pnpm 包管理器。 |
| 45 | + * **点评:** 如果你的项目用 pnpm,必须配合这个使用。 |
| 46 | +* **`ossjs/release-it`** (配合 NPM Script) 或 **`changesets/action`** |
| 47 | + * **作用:** 自动化版本管理和发布到 NPM。 |
| 48 | + * **点评:** 如果你是维护开源库,`changesets` 是目前管理 Monorepo 版本发布的最佳实践。 |
| 49 | + |
| 50 | +--- |
| 51 | + |
| 52 | +### 🔵 3. Python 开发者必备 |
| 53 | + |
| 54 | +Python 的痛点在于环境隔离和依赖工具多样(pip, poetry, pipenv)。 |
| 55 | + |
| 56 | +* **`actions/setup-python`** |
| 57 | + * **实用技巧:** 同样支持 `cache: 'pip'` 或 `cache: 'poetry'`。 |
| 58 | +* **`snok/install-poetry`** |
| 59 | + * **作用:** 如果你用 Poetry 管理依赖,这是目前体验最好的安装 Action。 |
| 60 | + * **点评:** 支持虚拟环境缓存配置,比直接 pip install poetry 更稳健。 |
| 61 | +* **`pre-commit/action`** |
| 62 | + * **作用:** 在 CI 中运行 `.pre-commit-config.yaml` 定义的检查。 |
| 63 | + * **点评:** 一次性跑完 Black, Isort, Flake8,保持 CI 和本地钩子一致。 |
| 64 | + |
| 65 | +--- |
| 66 | + |
| 67 | +### 🐹 4. Go 开发者神器 |
| 68 | + |
| 69 | +Go 的构建速度通常很快,重点在于 Lint 和 Release。 |
| 70 | + |
| 71 | +* **`actions/setup-go`** |
| 72 | + * **实用技巧:** 使用 `cache: true` 开启构建缓存。 |
| 73 | +* **`golangci/golangci-lint-action`** |
| 74 | + * **作用:** 运行 Go 社区最强的 Linter 集合。 |
| 75 | + * **点评:** 极其强大,能在 PR 中直接针对代码行进行评论(Annotations),比手动跑命令优雅得多。 |
| 76 | +* **`goreleaser/goreleaser-action`** |
| 77 | + * **作用:** Go 语言发布的终极方案。 |
| 78 | + * **点评:** 自动交叉编译(Windows/Linux/Mac)、打包、签名、上传 Release、推 Docker 镜像、更新 Homebrew Tap。Go 项目必装。 |
| 79 | + |
| 80 | +--- |
| 81 | + |
| 82 | +### 🦀 5. Rust 开发者救星 |
| 83 | + |
| 84 | +Rust 的痛点是 **编译极慢**。如果不用缓存,你的 Actions 额度会迅速耗尽。 |
| 85 | + |
| 86 | +* **`dtolnay/rust-toolchain`** |
| 87 | + * **作用:** 安装 Rust 工具链(stable/nightly/beta)。 |
| 88 | + * **点评:** **不要用** 已经没人维护的 `actions-rs/toolchain`。`dtolnay` 是 Rust 宏的大佬,他的这个 Action 是目前事实上的标准。 |
| 89 | +* **`Swatinem/rust-cache`** |
| 90 | + * **作用:** 智能缓存 `target/` 和 `~/.cargo`。 |
| 91 | + * **点评:** **最重要的 Rust Action**。它比通用的 `actions/cache` 更懂 Rust 的哈希键值计算,能极大节省编译时间。 |
| 92 | +* **`taiki-e/install-action`** |
| 93 | + * **作用:** 安装二进制工具(如 `cargo-nextest`, `cargo-audit`)而不需从源码编译。 |
| 94 | + * **点评:** 比如你想用 `cargo-nextest` 加速测试,如果用 `cargo install` 会编译很久,用这个直接下二进制,秒装。 |
| 95 | + |
| 96 | +--- |
| 97 | + |
| 98 | +### ⚙️ 6. PowerShell (Pwsh) 自动化 |
| 99 | + |
| 100 | +PowerShell Core (pwsh) 是跨平台的,这些 Action 帮你编写更好的脚本。 |
| 101 | + |
| 102 | +* **`microsoft/ps-scriptanalyzer-action`** (PSSA) |
| 103 | + * **作用:** 静态分析 PowerShell 代码(Linting)。 |
| 104 | + * **点评:** 检查你的 ps1 脚本是否符合最佳实践,避免 "脏" 脚本。 |
| 105 | +* **跨平台矩阵策略 (Matrix Strategy)** |
| 106 | + * 这不是一个 Action,而是一种技巧。Pwsh 的强大在于跨平台,你的 CI 应该这样写: |
| 107 | + |
| 108 | + ```yaml |
| 109 | + strategy: |
| 110 | + matrix: |
| 111 | + os: [ubuntu-latest, windows-latest, macos-latest] |
| 112 | + steps: |
| 113 | + - run: pwsh ./myscript.ps1 # 验证你的脚本在所有系统都能跑 |
| 114 | + ``` |
| 115 | + |
| 116 | +--- |
| 117 | + |
| 118 | +### 💡 总结:精选组合推荐 |
| 119 | + |
| 120 | +如果你在维护一个开源项目,这是我的 **"黄金起手式"**: |
| 121 | + |
| 122 | +1. **Go:** `setup-go` + `golangci-lint-action` + `goreleaser-action` |
| 123 | +2. **Rust:** `dtolnay/rust-toolchain` + `Swatinem/rust-cache` + `cargo test` |
| 124 | +3. **Python:** `setup-python` + `snok/install-poetry` + `ruff` (最近超火的 Rust 写的高速 Python Linter) |
| 125 | +4. **Node:** `setup-node` + `pnpm` + `changesets` |
| 126 | + |
| 127 | +**特别提醒:** 尽量使用 Action 的 `vX` 标签(如 `@v4`)而不是 master/main,以防止上游更新破坏你的流水线;同时,对于安全性要求极高的项目,建议锁定具体的 SHA 哈希值。 |
0 commit comments