VS Code中git克隆的Java项目提交推送后，.java不在项目classpath无法编译为.class

先明确问题本质 #

这个报错是VS Code的Java语言扩展没有识别到合法的源码根目录，和git本身的提交、克隆流程没有直接关系。很多人遇到这个问题的触发点是刚克隆项目时扩展临时把仓库根目录识别为源码目录，完成第一次提交推送后工作区重新扫描，扩展发现根目录结构不符合Java项目规范，就立刻抛出这个“文件不在classpath”的提示。通常是目录结构不规范、扩展识别错误、缓存失效、配置文件漏传这几个原因导致的。

具体排查解决步骤 #

• 首先校验项目源码目录结构是否符合规范

  • 不要把.java文件直接放在仓库根目录下，这种结构是无法被Java扩展识别为合法源码的
  • 标准的Java项目源码统一放在 src/main/java 路径下，Java文件要和自身声明的包路径对应存放：比如类里写了package com.test;，那文件的实际存放路径就应该是 项目根目录/src/main/java/com/test/你的类文件.java
  • 如果之前第一版提交的时候就是把Java文件直接丢在根目录，直接调整目录结构后重新提交推送，再拉取最新代码就会解决大部分问题。

• 手动给扩展指定正确的源码根目录

  • 如果目录结构已经是标准的，但扩展识别错了路径，直接在左侧资源管理器找到存放所有.java文件的那个文件夹
  • 右键点击该文件夹，选择 Add Source Root 选项，等几秒后原来的报错就会自动消失。

• 清理损坏的扩展工作区缓存

  • 要是前两步操作完还是报错，说明之前克隆项目时扩展缓存了错误的项目配置，和你推送的最新代码结构不匹配
  • 打开命令面板（Windows/Linux快捷键Ctrl+Shift+P，Mac快捷键Cmd+Shift+P），输入并选择 Java: Clean Java Language Server Workspace
  • 等待扩展自动重启、重新建立项目索引，索引完成后再检查报错状态。

• 排查git提交时的配置文件遗漏

  • 检查你第一次推送到远程仓库的文件列表，确认有没有漏传项目配置文件：用Maven构建的项目要传pom.xml，用Gradle构建的项目要传build.gradle，无构建工具的普通Java项目要传根目录下的.classpath、.project文件
  • 没有这些配置文件的话，扩展会把整个工作区当成普通文件夹，不会自动初始化Java项目结构，自然会判定所有Java文件不在classpath范围内。

内容的提问来源于stack exchange，提问作者Chris de Wet