github-workflows

GitHub 工作流

诊断、修复和优化 Rust 项目的 GitHub Actions 工作流。

快速参考

• 缓存策略 - 手动缓存、rust-cache、sccache
• 故障排除 - 常见问题、调试和修复方法
• 高级功能 - 覆盖率、安全和基准测试
• 发布管理 - 自动发布、版本管理

适用场景

• 为 Rust 项目设置 CI/CD
• 排查工作流失败问题
• 使用缓存缩短构建时间
• 确保测试、代码检查和发布符合最佳实践

更改前

务必先验证当前状态：

# Get repo info
gh repo view --json nameWithOwner,owner,name

# List existing workflows
gh workflow list

# Check recent runs
gh run list --limit 10

# View workflow files
ls -la .github/workflows/

完整的 Rust CI 工作流

查看完整的工作流模板，其中包括：

• 检查任务（格式、clippy、检查）
• 测试任务（单元测试、集成测试、文档测试）
• 覆盖率任务（tarpaulin、codecov）
• 审计任务（安全、许可证）

有关缓存策略、故障排除和发布管理，请查看链接文件。

核心工作流组件

任务	用途	工具
check	代码质量	rustfmt、clippy、cargo check
test	验证	cargo test
coverage	测试指标	cargo tarpaulin
audit	安全	cargo audit、deny

常见模式

• 缓存：依赖项、target 目录、sccache
• 矩阵构建：多个 Rust 版本和目标平台
• 条件任务：仅更改文档时跳过
• 质量门禁：失败时阻止合并

PR 检查关联保障

• 推送修复后，验证检查是否关联到 PR 的头部 SHA：
  • gh pr view --json statusCheckRollup,mergeStateStatus
  • gh run list --commit <head_sha>
• 如果必需检查的汇总为空，应视为受阻并调查触发条件和路径条件。