若SonarLint未检测已知Bug，需依次检查：一、确认文件语言绑定正确；二、启用对应规则或绑定SonarQube；三、确保源码路径未被排除；四、验证语言服务器启动及实时分析生效。
如果您在VSCode中使用SonarLint插件进行代码审查，但未能检测出已知的潜在Bug或规则未生效，则可能是由于插件配置未正确关联项目语言、规则集未启用，或分析范围受限。以下是解决此问题的步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、确认SonarLint与本地项目语言绑定正确
SonarLint需识别当前打开文件的语言类型并加载对应语言的规则引擎，若语言未被识别或绑定错误，静态分析将跳过该文件。
1、在VSCode中打开一个源码文件（如test.py或Main.java）。
2、查看窗口右下角状态栏，确认显示的语言标识（例如Python、Java、JavaScript）是否与文件实际类型一致。
3、若显示错误，点击该语言标识，在弹出菜单中选择正确的语言模式。
4、重新保存文件并等待SonarLint右下角状态图标变为绿色运行状态（非灰色暂停或红色禁用）。
二、启用项目级规则集并同步质量配置
SonarLint默认仅启用基础规则，部分潜在Bug（如空指针解引用、资源未关闭）需手动开启对应规则或连接SonarQube/SonarCloud服务器获取完整规则集。
1、按下Cmd+Shift+P（macOS）调出命令面板。
2、输入“SonarLint: Show Rules”并回车，打开规则列表视图。
3、在过滤框中输入关键词如“null pointer”或“resource leak”，定位目标规则。
4、对每条相关规则，点击右侧开关图标将其状态设为Enabled。
5、若项目已配置sonar-project.properties或已绑定SonarQube服务器，执行“SonarLint: Bind to SonarQube/SonarCloud”并完成认证流程。
三、检查文件是否被SonarLint排除分析
SonarLint默认跳过node_modules、.git、build等目录下的文件，若待分析代码位于非标准路径或被意外列入排除列表，将导致Bug无法被发现。
1、打开VSCode设置（Cmd+,），搜索“sonarlint.excludedFolders”。
2、确认该设置值中不包含当前项目源码所在路径，例如不应出现“src”或“app”等关键目录名。
3、在工作区根目录下查找.sonarlint文件夹，进入其子目录，检查rules.json中"exclusions"字段是否为空数组或未覆盖目标文件路径。
4、若存在误排除项，编辑该JSON文件，将对应路径从"exclusions"中移除，并保存。
四、验证分析器是否加载成功并触发实时扫描
SonarLint依赖后台语言服务器启动后才可执行语法树解析和数据流分析，若语言服务器未就绪，编辑器将无任何告警提示。
1、打开VSCode命令面板，执行“SonarLint: Show Output”。
2、在输出面板中切换至“SonarLint”通道，观察日志末尾是否存在“Analysis completed for X files”字样。
3、若出现“Language server not available”或“Failed to start”类错误，重启VSCode并确保已安装对应语言扩展（如Python、Java Extension Pack）。
4、新建一个含明显Bug的测试文件（如Java中调用null.toString()），保存后观察编辑器左侧是否立即出现波浪线及悬浮提示“NullPointerException will be thrown”。
