在C#项目开发过程中，使用SonarQube进行代码质量检测可以有效发现代码中的漏洞、坏味道以及重复代码等问题，帮助团队提升代码的规范性和可维护性。配置C#项目到SonarQube中需要完成环境准备、项目配置、扫描执行等多个步骤，下面将逐一说明。
环境准备
在正式配置之前，需要先准备好对应的运行环境，确保所有依赖工具都已正确安装。
- 已部署并正常运行的SonarQube服务，确保可以正常访问SonarQube的Web管理页面。
- 安装对应版本的JDK，SonarQube和SonarScanner都需要JDK环境支持，建议安装JDK 11及以上版本。
- 安装.NET SDK，根据C#项目的目标框架选择对应的版本，确保可以在命令行中执行dotnet命令。
- 下载SonarScanner for .NET工具，这是专门用于扫描.NET系列项目的扫描器，适配C#项目的扫描需求。
在SonarQube中创建C#项目
首先需要在SonarQube的管理页面中创建对应的项目，生成项目所需的令牌和配置信息。
创建项目
登录SonarQube的Web管理页面，点击顶部导航栏的Projects选项，然后点击Create Project按钮，选择Manually手动创建项目。
填写项目的唯一标识和显示名称，比如项目标识可以填写my-csharp-project，显示名称填写我的C#项目，然后点击Set Up完成项目创建。
生成访问令牌
项目创建完成后，会进入令牌生成页面，输入令牌名称，比如csharp-scan-token，然后点击Generate按钮生成令牌，复制保存好这个令牌，后续扫描时会用到。
接下来选择项目的主要开发语言为C#，然后选择对应的构建工具，C#项目一般选择.NET，之后会展示对应的扫描命令示例，我们可以参考这个示例完成后续的配置。
配置SonarScanner并执行扫描
将下载好的SonarScanner for .NET工具解压到本地目录，然后配置环境变量，将工具的bin目录添加到系统的PATH变量中，确保在命令行中可以直接执行dotnet-sonarscanner命令。
执行扫描命令
打开命令行工具，进入C#项目的根目录，按照SonarQube页面给出的命令示例，替换对应的参数后执行扫描。以下是一个典型的扫描命令示例：
# 开始扫描，配置SonarQube服务地址、项目令牌、项目标识和名称 dotnet-sonarscanner begin /k:"my-csharp-project" /d:sonar.host.url="http://127.0.0.1:9000" /d:sonar.login="生成的令牌内容" /n:"我的C#项目" # 执行项目构建，确保生成编译产物，扫描器需要读取编译后的信息 dotnet build # 结束扫描，将扫描结果上传到SonarQube dotnet-sonarscanner end /d:sonar.login="生成的令牌内容"
命令中的/k参数是项目的唯一标识，需要和SonarQube中创建项目时填写的标识一致；/d:sonar.host.url是SonarQube服务的访问地址，如果部署在本地默认端口就是http://127.0.0.1:9000；/d:sonar.login就是之前生成的访问令牌。
查看扫描结果
扫描命令执行完成后，打开SonarQube的Web管理页面，进入刚才创建的C#项目页面，就可以看到本次扫描的代码质量报告，包括代码问题数量、代码覆盖率、重复代码比例等相关信息。
常见问题及解决方法
- 扫描时提示找不到dotnet命令：检查.NET SDK是否正确安装，以及环境变量是否配置正确，可以在命令行执行
dotnet --version验证。 - 扫描结果中没有C#相关的规则命中：检查项目是否是.NET Core及以上版本的项目，旧版本的.NET Framework项目可能需要额外配置MSBuild扫描器。
- 上传扫描结果失败：检查SonarQube服务是否正常运行，令牌是否正确，以及项目标识是否和SonarQube中的配置一致。
注意事项
如果C#项目中包含单元测试，建议在扫描前执行单元测试并生成覆盖率报告，然后通过SonarScanner的参数将覆盖率报告路径配置进去，这样可以在SonarQube中看到代码的覆盖率情况。同时，建议将扫描命令集成到CI/CD流程中，每次代码提交后自动执行扫描，及时发现代码质量问题。
SonarQubeC#项目代码质量检测SonarScanner修改时间：2026-07-22 17:09:27