JetBrains IDE 怎样按范围运行代码检查

JetBrains IDE 的代码检查不必每次都扫整个项目。打开 Analyze > Inspect Code，在 Specify Inspection Scope 对话框里选择当前文件、目录、选中项、未提交文件或自定义 Scope，再指定 Inspection Profile，点击 Analyze 即可按范围检查。这样既能快速处理刚改动的代码，也能避免把一次局部排查误做成全项目扫描。

官方地址：https://www.jetbrains.com/help/idea/file-and-project-wide-analysis.html

下面以 IntelliJ IDEA 2026.2 的菜单名称为例，其他 JetBrains IDE 的入口名称可能因产品和版本略有差异。本文只讨论检查范围和结果核对，不讨论保存时自动格式化。

从 Analyze 菜单进入代码检查

先打开项目和要检查的代码，然后在顶部菜单选择 Analyze > Inspect Code。如果当前只想看编辑器里已经标出的单文件问题，也可以打开 View > Tool Windows > Problems，快捷键是 Alt+6；这属于当前文件的连续分析结果，不等同于一次手动的范围检查。

进入对话框后，先不要急着点击 Analyze。这里最重要的是确认两件事：第一，范围是不是你准备检查的代码；第二，Inspection Profile 是否包含需要的检查项。Profile 决定启用哪些 inspection、每项的严重级别，以及它们适用的文件范围。

按任务选择检查范围

范围选择可以按下面的顺序判断：

• 只改了一个文件：选择 File 或 Current File，适合快速确认刚编辑的文件。
• 要检查一个目录：选择 Directory；如果目录下还有子目录，确认范围包含递归内容。
• 只看 Project 工具窗口中选中的内容：选择 Selected Files，适合多个不连续文件的局部检查。
• 只检查本次改动：选择 All Changed Files 或未提交文件范围，避免旧问题淹没新问题。
• 团队有固定边界：选择 Custom Scope，把生产代码、测试代码或某个模块定义成可复用范围。

需要新建自定义 Scope 时，按 Ctrl+Alt+S > Appearance & Behavior > Scopes，点击加号并选择 Local 或 Shared。随后在 Scope 对话框中使用 Include、Include Recursively、Exclude 和 Exclude Recursively 调整文件集合，最后点击 Apply 保存。

Local Scope 只保存在本机配置中；Shared Scope 会放在项目的 .idea/scopes 下并可通过版本控制共享。个人临时排查用 Local 更省事，团队希望保持同一检查边界时再用 Shared。

点击 Analyze 后怎样确认结果

回到 Inspect Code 对话框，确认范围和 Profile 后点击 Analyze。结果窗口通常会按文件树、inspection 分组和严重级别展开。先看顶部或摘要里的 Scope，再点开 Error、Warning 等分组；如果结果里出现了范围外的目录，优先回到 Scope 定义检查 Include/Exclude，而不是立即修改检查规则。

单个问题可以双击跳回代码位置，或按 Alt+Enter 查看可用 quick-fix。不要把“没有结果”直接理解为“代码完全没有问题”：还要确认当前 Profile 启用了对应 inspection，目标文件属于选定 Scope，并且 IDE 已完成索引和分析。

范围不对或结果为空时怎么处理

最常见的第一个原因是把 Current File、Selected Files 和 Custom Scope 混用。重新打开检查对话框，先选一个最小范围，例如单文件；结果正常后，再逐步扩大到目录或自定义 Scope，这样容易判断问题出在范围定义还是 inspection 配置。

第二个原因是 Profile 没启用目标检查项。打开 Ctrl+Alt+S > Editor > Inspections，按语言或严重级别筛选，确认对应 inspection 没有被关闭。第三个原因是把“编辑器连续分析”和“项目级分析”当成同一功能：前者会在当前文件中提示问题，后者是单独的分析能力，官方文档还特别说明 IntelliJ IDEA 的 Project-wide analysis 当前主要面向 Java 项目，并依赖对应插件。

如果只是临时缩小范围，直接返回 Inspect Code 重新选择即可；如果 Scope 共享后影响了团队，先把 Shared 改回 Local 或调整 Include/Exclude，再保存。不要为了让结果变少而盲目降低所有 inspection 的严重级别。

相关问题

按范围检查会修改源代码吗？

运行 Inspect Code 本身主要生成检查结果。只有你主动选择 quick-fix 或代码清理动作时，才会进一步修改文件；修改前应先确认作用范围。

为什么目录范围没有包含子目录？

检查自定义 Scope 中是否使用了 Include Recursively。只点 Include 通常只加入当前目录下的文件，不会自动把嵌套目录全部加入。

团队应该选择 Local 还是 Shared Scope？

个人临时排查选择 Local；需要让团队复用相同文件边界时选择 Shared，并把 Scope 文件纳入版本控制。

总结一下：先用 Analyze > Inspect Code 打开入口，再按任务选择最小且准确的 Scope，确认 Inspection Profile 后运行 Analyze，最后在结果窗口核对范围、文件和问题分组。范围越明确，检查结果越容易读，也越不容易把局部问题误判成全项目问题。