sonarqube使用指北（二）-如何启动一次完整的本地扫描
内容提要
本文介绍了本地进行SonarQube代码扫描的步骤和配置，包括安全性、即时反馈和灵活性的优点，以及资源消耗和依赖问题的缺点。配置涵盖了SonarQube、Java和Maven的设置。最后，介绍了执行代码扫描并在SonarQube平台上查看结果的方法。
延伸解读
本地扫描的适用场景与权衡
文章指出本地扫描适合开发者在编写代码时获得即时反馈，并可根据需要自定义配置，且能在信任的环境下执行。但同时也提醒，本地扫描会消耗大量系统资源，尤其是大型代码库；此外，扫描结果可能因本地工具版本和配置不同而与其他环境不一致。因此，在采用本地扫描时，需权衡其灵活性与资源开销，并注意环境一致性可能带来的结果差异。
令牌配置的关键细节
在SonarQube中创建项目后，需要生成令牌用于授权本地扫描。文章强调，令牌仅在创建时显示一次，必须手动保存，否则只能重新创建。每个扫描项目只需在扫描时提供一个可用令牌即可，无需为每个项目单独创建。若希望在所有项目中使用同一个令牌，可以创建全局分析令牌，该令牌仅能执行扫描任务，无其他用户操作权限。
环境配置中的常见陷阱
文章以Mac安装Java 13为例，说明直接使用brew可能报错，需手动下载并放置到指定目录，同时执行xattr命令移除隔离属性，否则即使配置环境变量也无法运行Java。在Linux安装Maven时，文章特别提醒，部分AI教程建议编辑.bashrc或.bash_profile，但在CentOS下这些文件并不存在且无法生效，应编辑/etc/profile。这些细节有助于避免配置过程中的常见错误。
扫描执行与增量对比
完成所有配置后，在代码根目录下执行SonarQube生成的命令即可启动扫描。如果Maven配置正确，会从指定的私有仓库拉取依赖。扫描完成后，可在SonarQube平台查看结果。文章提到，在项目key不变的情况下，SonarQube会对比两次扫描的差异，并给出增量的测试结果，这有助于跟踪代码质量的变化。
Q&A
SonarQube本地扫描的优点是什么？
SonarQube本地扫描的优点包括安全性、即时反馈和灵活性。
如何在Mac上安装Java 13？
在Mac上安装Java 13可以通过手动下载JDK并配置环境变量来完成。
SonarQube项目的配置步骤有哪些？
SonarQube项目配置步骤包括登录SonarQube、创建项目、配置名称和生成令牌。
Maven的安装步骤是什么？
在Mac上安装Maven可以使用brew install maven命令，而在Linux上需要下载二进制包并配置环境变量。
如何执行SonarQube代码扫描？
在项目根目录下执行SonarQube命令即可开始代码扫描，并在SonarQube平台上查看结果。
SonarQube本地扫描的缺点是什么？
SonarQube本地扫描的缺点包括资源消耗大和依赖问题，可能导致扫描结果不一致。
