VSCode保存Java文件时出现虚假导入错误，切换窗口后消失

问题说明 #

保存或修改Java文件后，VSCode会高亮import com.papersaccul路径错误，但Gradle已配置正确的源码目录：

sourceSets {
    main {
        java {
            srcDirs = ['src/main/java']
        }
    }
}

切换窗口再切回VSCode后错误自动消失，Gradle构建运行完全正常，JetBrains系列IDE无此问题，推测是VSCode的Java语言服务（vscjava）缓存同步异常导致。

可行解决方案 #

• 强制清理Java语言服务缓存
  按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入并执行Java: Clean Java Language Server Workspace，完成后重启VSCode。这是修复语言服务缓存不同步最直接的方法。

• 更新插件并配置自动同步
  确保Language Support for Java(TM) by Red Hat和Gradle for Java插件为最新版本；在VSCode设置中搜索java.configuration.updateBuildConfiguration，将其值设为automatic，让IDE自动监听Gradle配置变化。

• 手动指定项目类路径
  在项目根目录的.vscode/settings.json中添加以下配置，强制VSCode识别Gradle构建后的类文件：

  {
      "java.project.referencedLibraries": [
          "build/classes/java/main/**/*.class",
          "build/libs/*.jar"
      ]
  }
  

• 排除构建目录的文件监听
  在VSCode设置中搜索files.watcherExclude，添加Gradle构建目录的排除规则，避免IDE频繁监听构建目录引发缓存混乱：

  {
      "files.watcherExclude": {
          "**/build/**": true
      }
  }
  

• 重置Gradle依赖同步
  按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），执行Gradle: Toggle Offline Mode，切换为离线模式后再切回在线模式，触发一次完整的依赖与配置同步。

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