安装JUnit Jupiter后项目导入路径异常，该如何解决？

问题根源 #

核心问题是源根目录识别混乱：Java的包结构基于源根目录，src应该是主代码的源根，而非包的一部分。之前普通类用src.BoardGameProject...导入，说明VSCode错误地把src当成了包层级的一部分；而Test文件夹放在src下，又导致测试类的源根识别和主代码冲突，进而出现导入路径需要不同写法的问题。

解决步骤 #

1. 调整项目结构（关键） #

把Test文件夹从src内部移到和src同级的位置，符合Java项目标准结构：

> lib (JUnit install created this folder)
> src 
    > BoardGameProject
        > domain
        > UI
    > images
> Test 
    > JUnitTest.java

2. 配置VSCode的Java源根 #

打开项目根目录下的.vscode/settings.json（没有则新建），添加以下配置，明确指定主源根和测试源根：

{
    "java.project.sourcePaths": ["src"],
    "java.project.testPaths": ["Test"]
}

3. 统一导入语句 #

删除所有普通类里的src.前缀，统一使用不带src的导入路径：

// 错误写法
// import src.BoardGameProject.UI.Frames.BuildModeScreen;

// 正确写法
import BoardGameProject.UI.Frames.BuildModeScreen;

测试类保持当前的导入写法即可，现在两者的导入路径会完全统一。

4. 生效配置 #

执行CTRL+SHIFT+P -> Java: Clean the Java language server workspace，选择Restart and Delete，等待VSCode重新加载项目。

调整后VSCode会正确识别主代码和测试代码的源根，导入路径冲突的问题不会再反复出现。

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