系统要求与准备工作
在开始安装SonarQube之前，需要确保满足系统要求，以避免后续运行中的兼容性问题，SonarQube对硬件和软件环境有一定要求，尤其是对Java版本的依赖性较高，确认操作系统支持Windows 10或更高版本，64位系统是必须的，硬件方面，建议至少4GB内存（推荐8GB以上），以及至少2GB的可用磁盘空间，用于存放SonarQube的文件和数据库数据。
Java环境是SonarQube运行的核心，必须安装Java Development Kit（JDK）11或17（不支持更高或更低版本），可以通过命令行检查Java版本：打开CMD，输入java -version，若未安装或版本不符，需从Oracle官网下载对应版本的JDK并配置环境变量，建议提前关闭Windows防火墙或添加SonarQube的端口（默认9000）到例外列表，避免连接问题。
下载SonarQube安装包
SonarQube的官方下载地址为sonarqube.org，进入页面后选择“Latest Release”获取最新稳定版本，下载时需注意区分社区版（Community Edition）和企业版（Enterprise Edition），社区版免费且功能已满足大多数中小型项目需求，适合个人或团队使用，下载文件为.zip格式，大小约为500MB-1GB，根据网络情况耐心等待完成。
下载完成后，将文件解压到固定目录，如D:\sonarqube，建议避免路径中包含中文字符或空格，防止因路径问题导致启动失败，解压后的目录结构包含bin、conf、data、logs等文件夹，其中bin目录包含启动脚本，conf目录存放配置文件，后续修改主要集中于此。
配置环境变量
为方便SonarQube的启动和管理，建议添加系统环境变量，右键“此电脑”选择“属性”，进入“高级系统设置”点击“环境变量”，在“系统变量”中新建SONAR_HOME，值为SonarQube的解压目录（如D:\sonarqube），在Path变量中添加%SONAR_HOME%\bin，以便在命令行中直接调用SonarQube命令。
配置完成后，打开新的CMD窗口，输入sonar.bat start测试是否生效，若提示“SonarQube started”则表示环境变量配置成功，若出现错误，需检查SONAR_HOME路径是否正确，以及Java版本是否符合要求。
修改配置文件
SonarQube的核心配置文件位于conf\sonar.properties，默认使用内置的H2数据库，但生产环境建议使用PostgreSQL或MySQL以提高性能，若使用内置数据库，可暂时跳过数据库配置，直接修改以下关键参数：
sonar.web.host：绑定访问地址，默认0.0.0表示允许任何IP访问。sonar.web.port：端口号，默认9000，若被占用可修改为其他端口（如8080）。sonar.log.path：日志文件路径，默认为logs目录，可自定义绝对路径。
若使用PostgreSQL数据库，需先安装数据库并创建用户，然后在sonar.properties中取消注释并修改以下配置：
sonar.jdbc.url=jdbc:postgresql://localhost:5432/sonarqube sonar.jdbc.username=sonar sonar.jdbc.password=your_password sonar.suffix=.pgsql
启动SonarQube服务
SonarQube提供了多种启动方式，推荐使用命令行或Windows服务，通过命令行启动时，进入bin\windows-x86-64目录（根据系统选择对应文件夹），双击StartSonar.bat或运行sonar.bat start，启动后，等待1-2分钟，看到“SonarQube is up and running”即表示成功。
若希望设置为Windows服务，可使用winsw工具，下载winsw.exe并重命名为sonar-service.exe，同目录下创建配置文件sonar-service.xml如下：
<service> <id>sonarqube</id> <name>SonarQube</name> <description>SonarQube instance</description> <executable>%SONAR_HOME%\bin\windows-x86-64\sonar.bat</executable> <startmode>auto</startmode> </service>
执行sonar-service.exe install安装服务，通过services.msc管理SonarQube的启动和停止。
访问与验证
启动成功后，打开浏览器，访问http://localhost:9000（若修改了端口则对应更改），首次访问会提示设置管理员密码，输入新密码后登录，默认用户名为admin，登录后，可在“Dashboard”查看系统状态，包括数据库连接、插件状态等，若出现“Connection refused”错误，需检查防火墙设置或端口占用情况；若提示数据库错误，需核对sonar.properties中的数据库配置。
插件安装与优化
SonarQube支持通过插件扩展功能，如代码扫描规则、语言支持等，登录后进入“Administration”-“Marketplace”，搜索所需插件（如“Java”“Python”），点击“Install”即可，安装插件后需重启SonarQube生效。
为提升性能，建议定期清理data目录下的旧文件，并通过sonar.properties调整JVM参数，如：
sonar.web.javaOpts=-Xms512m -Xmx512m -XX:+UseG1GC
根据服务器内存调整-Xms和Xmx值，避免内存不足导致服务崩溃。
相关问答FAQs
Q1: SonarQube启动后无法访问，提示“Connection refused”怎么办？
A: 首先检查防火墙是否阻止了9000端口，可临时关闭防火墙测试，使用netstat -ano | findstr 9000查看端口是否被占用，若被占用则修改sonar.properties中的sonar.web.port，确认SonarQube进程是否正常启动，查看logs\sonar.log文件中的错误信息。
Q2: 如何更换SonarQube的数据库？
A: SonarQube支持PostgreSQL、MySQL等数据库，首先安装目标数据库并创建用户及数据库，然后备份data目录下的旧数据（可选），接着修改conf\sonar.properties中的JDBC配置，指向新数据库，最后重启SonarQube,若数据迁移需使用官方提供的迁移工具或手动导入数据。
标签： sonar windows安装教程详细步骤 sonar windows详细安装步骤教程 sonar windows安装详细步骤教程
