GitHub Actions中用dotnet/cli构建.NET项目的关键步骤
默认的
.github/workflows/dotnet.yml模板能跑通，但容易在 restore 或 publish 阶段失败，根本原因是没显式指定 SDK 版本和运行时目标。CI 环境不保证预装你本地用的 .NET SDK，尤其当你用的是 .NET 6+ 的隐式 usings 或
Nullable全局设置时。
实操建议：
在 workflow 文件顶部用actions/setup-dotnet@v4显式安装所需版本，例如
dotnet-version: '8.0.x'（
x表示允许补丁更新）
dotnet restore必须在
dotnet build前单独执行，且推荐加
--no-cache避免 CI 缓存污染 若项目含多个
.csproj（如类库 + WebAPI + Tests），用
dotnet build ./MySolution.sln更可靠，而非对单个项目调用
build测试阶段务必用
dotnet test --no-build，避免重复编译；若需代码覆盖率，再额外加
--collect:"XPlat Code Coverage"并配合
coverlet.collector包
如何让 GitHub Actions 正确识别并运行 xUnit/NUnit 测试
常见现象是 workflow 显示
Build succeeded，但测试步骤直接跳过，或报错
No test assemblies found。这通常不是测试没写，而是
dotnet test没找到含
[Fact]或
[Test]的程序集。
实操建议：
确保测试项目引用了对应框架包：Microsoft.NET.Test.Sdk+
xunit（或
NUnit3TestAdapter） 在 workflow 中明确指定测试项目路径，例如
dotnet test ./src/MyApp.Tests/MyApp.Tests.csproj，不要只写
dotnet test若测试项目依赖本地 NuGet 包或 project reference，确认
dotnet restore已覆盖全部项目（可加
--source参数指向 private feed） 遇到
System.DllNotFoundException类错误，大概率是测试中用了 Windows-only API，需在 job 中设
runs-on: windows-latest，或改用跨平台等价实现
发布带符号文件（.pdb）和 NuGet 包的注意事项
本地
dotnet pack能生成 .nupkg 和 .snupkg，但 CI 中常漏掉符号包，或上传后 NuGet.org 不认。核心问题在于：符号包必须与主包完全匹配（相同 version、assembly version、hash），且需用
dotnet nuget push单独上传。
实操建议：
打包时加参数：dotnet pack --configuration Release --include-symbols --symbol-package-format snupkg生成的
.snupkg文件不会自动上传，必须显式调用
dotnet nuget push *.snupkg -s https://api.nuget.org/v3/index.json -k ${{ secrets.NUGET_API_KEY }}
若项目使用 Directory.Build.props控制
Version，确保 CI 中未被
GITHUB_RUN_NUMBER等变量意外覆盖；建议用
dotnet msbuild -getProperty:Version验证实际值 符号服务器验证：上传后访问
https://api.nuget.org/v3/debug/symbols/YourPackage/{version}/YourPackage.pdb/{hash}/YourPackage.pdb，看是否返回 200
敏感配置（连接字符串、密钥）的安全注入方式
把
ConnectionStrings:Default写进
appsettings.json并提交到仓库是高危操作。GitHub Actions 提供
secrets，但不能直接映射为环境变量传给
dotnet run—— 因为 .NET 默认只从
DOTNET_*或
ASPNETCORE_*前缀变量读取配置。
实操建议：
用env:将 secret 注入 job，再通过
--environment或
ASPNETCORE_ENVIRONMENT=Production触发
appsettings.Production.json加载 更灵活的方式是运行时替换：用
sed -i "s/PLACEHOLDER/${{ secrets.DB_CONN }}/g" appsettings.json（Linux/macOS）或 PowerShell 的 (Get-Content appsettings.json) -replace ... | Set-Content（Windows） 若用 Azure Key Vault 或 AWS Secrets Manager，建议在 startup 中用
AddAzureKeyVault或
AddSecretsManager，而非提前解密塞进 config 文件 切记：所有含 secret 的 job 必须设
if: github.event_name == 'push' && github.repository == 'owner/repo'，防止 fork PR 泄露 实际配置中最容易被忽略的，是
setup-dotnet的版本通配符（比如写成
'7.0'而非
'7.0.x'）导致后续 patch 更新失败，以及测试项目未显式指定路径导致
dotnet test扫描空目录。这些细节不报错，但会让 pipeline 表面成功、实际失能。
