IntelliJ IDEA 能直接使用 WSL2 中的 JDK、Maven 和项目路径，但必须手动配置 WSL Toolchain（而非仅选择 JDK 路径），指定正确发行版名称，并使用 \wsl.localhost... 格式路径打开项目，否则默认调用 Windows 工具链导致构建失败。
IntelliJ IDEA 能直接用 WSL 2 里的 JDK、Maven 和项目路径，但必须手动指定 WSL 工具链，否则它默认只认 Windows 上的 Java —— 这是绝大多数人配不成功的第一原因。
WSL 环境本身要先跑通
IDEA 不会帮你装 WSL 或修系统级问题。你得先确认：
-
wsl --list --verbose输出里有STATE: Running且版本是2 - 在 Ubuntu（或其他发行版）终端里能正常运行
java -version和mvn -v - 如果用的是非 Ubuntu 发行版（比如 Alpine），
iproute2包必须已安装，否则 IDEA 启动 WSL 进程时会卡在连接阶段 - 防火墙没拦
wsl.exe或ubuntu.exe的出站连接 —— 尤其是调试时断点不生效，常是这个原因
在 IDEA 里添加 WSL Toolchain
不是“选个 JDK 路径”就完事，而是要让 IDEA 明白：“所有构建、运行、调试动作，都交给 WSL 里的命令去执行”。操作路径是：File > Settings > Build, Execution, Deployment > Toolchains。
- 点
+→ 选WSL，不是Linux或Remote Host -
Distribution下拉框必须选中你实际安装的那个名字，比如Ubuntu-22.04，而不是Ubuntu（WSL 允许重命名，IDEA 会按真实名称识别） - 不要手动填
Path to shell：默认/bin/bash即可；改了反而容易因 shell 初始化脚本缺失环境变量而失败 - 加完后，这个 Toolchain 会自动关联到新建项目的
JDK和Maven home path，但旧项目需手动在Project Structure > Project > Project SDK里重新选一遍 WSL 下的 JDK
项目路径必须用 \wsl.localhost... 格式
Windows 文件资源管理器能直接访问 WSL 文件系统，但 IDEA 内部用的是 UNC 路径映射。如果你把项目建在 C:wsl-projects 再“挂载进 WSL”，IDEA 会当成纯 Windows 项目处理，构建仍走 Windows JVM。
- 新建项目时，
Location字段必须填类似\wsl.localhostUbuntuhomelicemyapp - 打开已有项目时，不能双击 Windows 下的 .iml 文件，而要从 IDEA 欢迎页点
Open，然后导航到\wsl.localhost...路径下选中项目根目录 - 路径里不能出现空格或中文——WSL 的
bash对 UNC 路径解析不稳定，遇到空格大概率报No such file or directory
调试时端口不通？检查 WSL2 的 NAT 网络行为
WSL2 是虚拟机架构，它的 IP 每次重启可能变，IDEA 调试器靠反向连接（remote JVM debug）通信，不是简单的 localhost 绑定。
- 确保
Run/Debug Configurations > Configuration > Use alternative JRE里勾选了 WSL Toolchain 对应的 JDK，而不是 Windows 的 - 调试配置中的
Host填localhost即可，IDEA 会自动通过 WSL 的 host-to-WSL 代理转发请求 - 如果断点始终不触发，运行
netstat -tuln | grep :5005（假设 debug 端口是 5005）看 WSL 里进程是否真在监听；没监听说明启动参数没传进 WSL JVM，常见于 Maven 插件配置写死 Windows 路径
最易被忽略的一点：WSL 工具链一旦配置成功，所有构建日志、控制台输出、甚至 Maven 的 ~/.m2 缓存，全都在 WSL 文件系统里。别去 Windows 的 C:Users... 下找日志，也别手动删 WSL 里的 .m2 目录——除非你清楚自己在清理什么。
