如何解决IntelliJ IDE卡在“Preparing WSL build environment...”的问题？

1. 禁用WSL文件系统同步 #

IntelliJ的WSL文件系统监控可能引发阻塞：

• 打开Settings → Build, Execution, Deployment → Deployment → WSL
• 找到对应Ubuntu实例，取消勾选Enable file system synchronization
• 重启IntelliJ后重新构建

2. 切换至WSL1测试兼容性 #

WSL2的虚拟层可能存在兼容性问题，临时切换验证：

# Windows PowerShell中执行
wsl --set-version Ubuntu-22.04 1

若构建恢复正常，可选择继续使用WSL1，或更新WSL2内核：

wsl --update

3. 改用Windows本地Maven/JDK #

避免跨WSL的资源调用延迟：

• 打开Settings → Build, Execution, Deployment → Build Tools → Maven
• 将Maven home directory设置为Windows本地安装的Maven路径
• 同时在Build, Execution, Deployment → Build Tools → Maven → Importing中，将JDK for importer指定为Windows本地JDK

4. 清理IntelliJ缓存与项目构建文件 #

• 关闭IntelliJ，删除项目根目录下的.idea和target文件夹
• 重启IntelliJ，选择File → Invalidate Caches...，勾选Invalidate and Restart

5. 修复WSL DNS解析问题 #

DNS异常可能导致Maven依赖下载阻塞：

• 在Ubuntu中编辑/etc/wsl.conf，添加：

[network]
generateResolvConf = false

• 执行以下命令替换DNS配置：

sudo rm /etc/resolv.conf
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf
sudo chattr +i /etc/resolv.conf

• 在Windows PowerShell中重启WSL：

wsl --shutdown

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