0. 前言
本文介绍基于 WSL（Windows Subsystem for Linux）搭建 IDEA+WSL 开发环境。看完本文，你完全可以把 Windows 变成纯终端，用 IDEA 远程连接 WSL 进行日常开发。
若你尚未安装 WSL，请参考这篇文章《极简 WSL2 教程：开发、部署大模型必备》。
若你尚未在WSL中安装 OpenCode，请参考这篇文章《WSL + OpenCode 最佳实践：环境一致、模型配置、GUI 远程使用》。
若你尚未配置WSL的开发环境，请参考这篇文章《2026 最新版：WSL + Ubuntu 全栈开发环境，一篇搞定！》。
完成以上环境安装配置后，再执行下文的 IDEA+WSL 开发环境搭建操作。
1. 不要安装最新版本(2026.1)的 IDEA
可以肯定的是不能安装最新版本(2026.1)的 IDEA，这个版本的 IDEA 连接 WSL 虽然可以连接成功，但是运行项目的时候总是报错：Failed to find compatible JDK。IDEA 官方已经确认了这个 BUG，idea 的官方 issue 为： idea 官方 issue。详细报错截图如下：
IDEA 官方的 issue 截图如下：
2. 安装 2025.3.3 版本的 IDEA
去IDEA官网下载页面下载2025.3.3版本的 IDEA。恰好 IDEA 从 2025.3 版本起宣布免费，且该版本开始不再区分 Community（社区版）和 Ultimate（旗舰版），仅保留单一安装版本。
现在只有部分高级功能还是收费的。高级功能通常无需使用，基础功能已能满足日常开发需求，因此对多数程序员而言，IDEA 可视为免费使用。
安装好后打开idea。
3. 两种方式连接 WSL
3.1 点击 idea 上方的 File 菜单-非原生 WSL 连接
非原生 WSL 连接方式，会在 WSL 系统中安装一个轻量级的 IDEA 服务端程序。我们在 Windows 系统的 IDEA 客户端上的所有操作，都会转发至 WSL 中的这个轻量级 IDEA 服务端。该 IDEA 服务端会在 WSL 中执行代码运行逻辑，再将运行结果回传给 Windows 系统的 IDEA 客户端。
首次连接时，IDEA 会在你的 WSL 环境中自动下载一个 IDEA 服务端程序（非客户端），你可自定义其安装路径。如下截图：
正在下载中~~~
下载成功之后，点击 File --> Remote Development 连接 WSL。
3.2 从 idea 欢迎页点击 Remote Development-原生 WSL 集成模式
原生 WSL 集成模式则无需依赖 WSL 中的轻量级 IDEA 服务端。Windows 系统的 IDEA 客户端可直接访问并操作 WSL 中的文件与代码。但该原生 WSL 集成模式当前存在已知 BUG，暂无法正常使用。BUG 演示过程如下截图：
注意：该方式无需在 WSL（Linux）环境中安装 IDEA 程序。
3.3 关闭原生 WSL 集成模式
关闭原生 WSL 集成模式的操作步骤：依次点击设置入口 → 找到 WSL 集成相关选项 → 取消勾选原生集成模式 → 保存设置并重启 IDEA。
3.4 恢复语言为英文-禁用中文插件
4. 创建一个新项目保存在 WSL 文件系统里面
4.1 配置 JDK
配置 JDK：选择 WSL 环境中已安装的 JDK 路径，确认版本与项目兼容。
4.2 配置 maven
4.3 运行类配置
4.4 显示终端 Terminal
5. 在 IDEA 中运行 OpenCode
5.1 将终端移动到右边
5.2 将终端变成独立窗口
结尾
觉得有用的话，欢迎点赞、在看、转发给身边的开发者！
关注我，后续持续更新开发环境、效率工具、大模型落地等硬核干货，下期带你用 WSL 部署本地大模型，让 OpenCode 直接调用本地大模型。再也不用花钱买 token 了。(❁´◡`❁)。
参考资料 [1]
idea官方issue: youtrack.jetbrains.com/issue/IJPL-…
[2]
IDEA官网下载页面: www.jetbrains.com/idea/downlo…
