VS Code自动编译所有.java文件并跨文件报错该如何解决

行为归属判定 #

该全局扫描报错的行为是VS Code Java生态扩展的默认逻辑，并非Java本身的特性。
原生Java编译工具javac默认仅编译你指定的源文件，以及该文件直接/间接依赖的其他类文件，不会主动扫描工作目录下所有未关联的.java文件进行校验。你在单个文件报错中看到其他不相关文件的问题，完全是VS Code的Java语言服务扩展导致的。

问题产生原因 #

你当前使用的VS Code默认安装了Language Support for Java(TM) by Red Hat扩展，该扩展负责Java语法实时检查、代码提示、编译预处理等能力，其默认逻辑为：

• 将你当前打开的根文件夹（即JavaWork文件夹）视为单个完整Java项目的工作区
• 自动扫描工作区下所有层级的.java文件做全局静态语法校验，所有扫描到的错误会统一汇总到问题面板，无论你当前打开的是哪个文件、是否要运行该文件
• 即使你将独立代码放到子文件夹，只要子文件夹属于当前打开的工作区范围，依然会被纳入全局扫描

问题示意：

修复方案 #

你可以根据自己的使用场景选择以下任意一种方案：

• 方案1：独立打开单个练习代码的文件夹
  如果你的多个.java文件都是无关联的练习代码，每次仅打开单个代码文件所在的文件夹作为工作区，不要把所有练习代码都放在同一个JavaWork文件夹下统一打开。
• 方案2：配置扩展排除不需要扫描的路径
  若要保留所有代码放在同一个工作区的使用习惯，可以修改扩展配置关闭无关路径的扫描：
  1. 打开VS Code设置，搜索Java > Problems: Excluded Sources
  2. 添加不需要校验的文件夹路径，即可避免这些路径下的代码被扫描报错
• 方案3：为每个独立代码单元配置独立项目
  在每个存放独立代码的子文件夹下新建.vscode/settings.json文件，添加如下配置，即可让扩展将每个子文件夹识别为独立项目，不会跨项目报错：

  {
    "java.project.sourcePaths": ["."]
  }
  

• 方案4：指定运行时仅编译当前文件
  修改运行配置，避免运行单个文件时编译其他无关文件：打开工作区下的.vscode/launch.json，在对应运行配置中添加compileArguments参数：

  {
    "type": "java",
    "name": "Launch Current File",
    "request": "launch",
    "mainClass": "${file}",
    "compileArguments": ["${file}"]
  }
  

内容的提问来源于stack exchange，提问作者user16486258