如何通过本地Jenkins实例运行Bitbucket仓库中的C# NUnit自动化测试

1. 打通Jenkins和Bitbucket的连接 #

• 安装Jenkins的Bitbucket插件：进入Jenkins插件管理页面，搜索Bitbucket完成安装后重启Jenkins
• 添加Bitbucket凭据：进入Jenkins全局配置，新增凭据，选择「用户名+密码」或「SSH密钥」类型，给凭据设置一个易记的ID（比如bitbucket-creds）后保存

2. 创建Jenkins任务 #

• 新建「自由风格项目」，设置一个合适的任务名称
• 源码管理选择Git，填写Bitbucket仓库的克隆URL（HTTPS或SSH格式均可，要和你添加的凭据类型匹配）
• 指定需要拉取的分支（比如*/main）
• 在凭据下拉列表中选择刚才创建的Bitbucket凭据

3. 编译项目（核心前置步骤） #

• 添加构建步骤：选择「执行Windows批处理命令」（Windows节点）或「执行Shell」（Linux/macOS节点）
• 运行对应编译命令：
  • 若使用.NET Core/.NET 5+：

    dotnet restore
    dotnet build --configuration Release
    

  • 若使用旧版.NET Framework项目，需先安装MSBuild工具，再运行：

    msbuild YourProject.sln /p:Configuration=Release
    

4. 运行NUnit测试 #

• 再添加一个构建步骤，同样选择批处理或Shell，运行测试命令：
  • .NET Core/.NET 5+直接使用dotnet test：

    dotnet test YourTestProject.csproj --configuration Release --logger "console;verbosity=detailed" --results-directory ./TestResults
    

  • .NET Framework需使用NUnit控制台运行器（可通过NuGet全局安装，或在项目中引入NUnit.ConsoleRunner包），示例命令：

    packages/NUnit.ConsoleRunner.3.16.3/tools/nunit3-console.exe YourTestProject/bin/Release/YourTestProject.dll
    

• 可选优化：安装NUnit Plugin for Jenkins，添加「发布NUnit测试结果报告」的构建后步骤，指定测试结果文件路径（比如TestResults/*.xml），即可在Jenkins中直接查看测试通过率、失败用例详情

5. 常见问题排查 #

• 拉取代码失败：检查凭据是否正确、仓库URL是否输入错误、Jenkins服务器能否正常访问Bitbucket
• 编译失败：确认Jenkins节点已安装对应版本的.NET SDK/.NET Framework，且环境变量已配置SDK路径
• 测试无法运行：检查测试项目是否正确引用NUnit包、控制台运行器版本与项目NUnit版本是否兼容、测试DLL路径是否输入错误

内容的提问来源于stack exchange，提问作者Harish Patil