摘要本文是一篇面向 Windows 开发者的 SonarQube 本地代码质量扫描环境搭建教程。文章从零开始依次讲解 Docker Desktop 与 WSL2 的安装、国内镜像加速配置、WSL2 内存限制设置、SonarQube 容器启动、JDK 17 环境确认、项目编译、访问令牌生成以及最终的扫描配置与执行。全文步骤清晰、命令完整适合需要在本机快速搭建 SonarQube 扫描环境的 Java 开发者参考。提示Docker Desktop 不强制要求登录可以直接跳过登录毕竟本次只需要扫描本地代码。## 1. 环境准备安装 Docker Desktop 与 WSL2首先下载 Docker Desktop 客户端它能够保证 Docker 在 Windows 环境下正常使用。在 PowerShell 中执行以下命令下载安装包Invoke-WebRequest-Urihttps://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe-OutFile$env:USERPROFILE\Downloads\DockerDesktopInstaller.exe接着安装 WSL2在 PowerShell 中执行wsl--install然后下载 SonarScanner 扫描器SonarScanner 6.2.1.4640 压缩包下载链接下载后解压到 D:/sonar-scanner 文件夹内Docker Desktop 直链下载地址对应版本为最新版下载之后记得配置对应的环境变量按Win R输入sysdm.cpl打开环境变量配置在Path中新增D:\sonar-scanner\sonar-scanner-6.2.1.4610-windows-x64\bin此处仅为示例实际位置以自己的安装位置为准。2. 配置 Docker 国内镜像加速以上全部下载完成后打开 Docker Desktop点击Settings找到Docker Engine将里面的 JSON 直接修改为以下内容{builder:{features:{buildkit:true},gc:{defaultKeepStorage:20GB,enabled:true}},experimental:false,registry-mirrors:[https://docker.1panel.live,https://docker.m.daocloud.io,https://hub.rat.dev]}这里主要配置了三个国内镜像加速网站否则 Docker 容易连接不上服务器。配置完成后点击Apply Restart重启 Docker。3. 配置 WSL2 内存限制先打开文件管理器输入以下路径%UserProfile%在用户文件夹中寻找.wslconfig文件。如果没有这个文件就新建一个使用记事本打开并输入[wsl2] memory6GB swap2GB这段代码必须保证一个字都不能错包括空格。接着检查 WSL2 状态依旧在 PowerShell 中执行wsl-l-v返回的 WSL 有两个版本就说明安装成功了。以上任何一步出现错误均可以重启电脑之后解决。4. 启动 SonarQube 容器完成上述步骤之后在 PowerShell 中运行dockerrun-d--namesonarqube-p9000:9000 sonarqube:lts-community该命令会拉取远程镜像镜像大小约为 1GB需要一点时间请耐心等待不要关闭 PowerShell。当拉取完毕时会返回一个字符串内容是容器 ID此时就差不多成功了。5. 确认 JDK 17 环境接下来需要保证本机上有 JDK 17因为 SonarQube 扫描是使用 JDK 17 进行的。项目用几无所谓不需要设置到项目当中。用以下代码确定 JDK 17 的位置后面会用到Get-ChildItemC:\Program Files\Java,C:\Program Files\Eclipse Adoptium,D:\Java-ErrorAction SilentlyContinue|Select-ObjectFullName例如本机上的位置是C:\Program Files\Eclipse Adoptium\jdk-17.0.17.10-hotspot。6. 编译项目接着编译要扫描的项目因为扫描时需要用到 class 产物cdd:\B-WorkSpace\product-management mvn cleaninstall-DskipTests7. 生成访问令牌上述步骤都完成并确认之后打开http://localhost:9000。首次登录账号密码是admin/admin系统会要求设置新密码。登录后点击右上角头像 →My Account→Security找到Generate Token / 生成令牌填一个名字如local点击生成。例如生成的令牌为sqa_02b7b3497f1416fa5323022bd0ea3fab5b5fbxxx。8. 编写扫描配置文件在项目的根目录新建sonar-project.properties文件写入以下内容sonar.projectKeyproduct-management sonar.projectNameproduct-management sonar.projectVersion1.0 sonar.sourcessrc/main/java sonar.java.binariestarget/classes sonar.sourceEncodingUTF-8 sonar.host.urlhttp://localhost:9000 sonar.loginsqa_02b7b3497f1416fa5323022bd0ea3fab5b5fbxxx9. 执行扫描最后直接在 PowerShell 中执行cd d:\B-WorkSpace\product-management$env:JAVA_HOME C:\Program Files\Eclipse Adoptium\jdk-17.0.17.10-hotspot$env:Path $env:JAVA_HOME\bin;$env:Pathd:\sonar-scanner\sonar-scanner-6.2.1.4610-windows-x64\bin\sonar-scanner.bat稍等几分钟扫描完成后即可在 SonarQube 控制台查看代码质量报告。至此本地 SonarQube 代码质量扫描环境搭建完成。