C#如何为GitHub Actions配置CI/CD .NET项目自动化构建与部署

为.NET项目配置GitHub Actions CI/CD需编写.yml工作流文件，核心包括：选对运行器、正确还原依赖、适配SDK版本、安全管理密钥；基础CI含build与test；CD可生成nupkg或publish产物；部署时用secrets注入凭证；支持矩阵策略实现跨平台构建。

为 .NET 项目在 GitHub Actions 上配置 CI/CD，核心是写好 .yml 工作流文件，让 GitHub 自动完成构建、测试、打包和部署（如推送到 NuGet、Azure 或 GitHub Packages）。关键在于选对运行器（windows-latest / ubuntu-latest）、正确还原依赖、适配 SDK 版本，并安全地管理敏感凭据。

基础 CI 流程：构建 + 单元测试

这是最常用起点，适用于大多数 .NET 库或 Web API 项目。使用官方 actions/setup-dotnet 设置 SDK，再用 dotnet build 和 dotnet test 验证代码质量。

• 在项目根目录创建 .github/workflows/ci.yml
• 指定触发条件，例如 push 到 main 或 pull_request
• 用 setup-dotnet 安装匹配项目 global.json 或 .csproj 的 SDK 版本（如 7.0.x 或 8.0.x）
• 执行 dotnet restore → dotnet build --configuration Release → dotnet test --no-build --verbosity normal

带发布产物的 CD 流程：生成 nuget 包或 zip 发布项

构建成功后，可自动生成可分发的产物。比如类库项目打成 .nupkg，Web 项目发布为 zip 或 publish 目录。

• 添加 dotnet pack 步骤（需项目含 <packageid></packageid> 和 <version></version>）并输出到 ./artifacts
• 对 Web 项目用 dotnet publish -c Release -o ./publish 生成部署就绪文件
• 用 actions/upload-artifact 上传产物，便于后续步骤下载或手动下载验证
• 若版本号来自 Git 标签，可用 git describe --tags 或 github.event.release.tag_name 动态设置 VERSION

安全部署到 NuGet.org 或 GitHub Packages

部署环节必须保护 API 密钥。GitHub 推荐用 secrets（项目 Settings → Secrets and variables → Actions）存凭证，再在 workflow 中引用。

标签： linux js git json windows github 操作系统 编码 ubuntu mac ai macos