IDEA+WSL配置全攻略：连接、运行与避坑指南

本文详细介绍如何通过 WSL（Windows Subsystem for Linux）搭建 IDEA + WSL 远程开发环境。按照本教程操作，你可以将 Windows 转变为纯终端工作流，利用 IDEA 远程连接 WSL 完成日常编码任务。

1. 避开 IDEA 最新版（2026.1）的陷阱

先提醒一句：千万别尝鲜安装 IDEA 2026.1 版本。虽然它能正常连接 WSL，但运行项目时会弹出 Failed to find compatible JDK 错误。该 Bug 已获 JetBrains 官方确认，详情可查阅文末的官方 issue 链接。下面贴出报错截图和官方确认截图。

2. 安装 IDEA 2025.3.3 版本

既然新版有坑，那就退一步，从 IDEA 官网下载 2025.3.3 版本。巧的是，从 2025.3 版本开始官方宣布免费，且不再区分社区版和旗舰版，仅提供单一版本。目前仅部分高级功能需付费，但日常开发所需的基础能力完全够用——某种意义上，对大多数程序员来说 IDEA 已经算是免费工具了。

安装完成后直接启动 IDEA。

3. 两种连接 WSL 的方式

3.1 通过 IDEA 顶部 File 菜单 → 非原生 WSL 连接

这种方式会在 WSL 内部安装一个轻量级的 IDEA 服务端程序。你在 Windows 的 IDEA 客户端中执行的所有操作，都会被转发到 WSL 中的这个服务端去运行，再将结果返回。可以把它理解为“远程桌面”的简化实现。

首次连接时，IDEA 会自动在 WSL 环境中下载一个服务端程序（并非完整客户端），你可以自定义安装路径。

正在下载中…

下载成功后，依次点击 File → Remote Development 连接 WSL。

3.2 从 IDEA 欢迎页点击 Remote Development → 原生 WSL 集成模式

原生集成模式不需要在 WSL 中安装服务端。Windows 上的 IDEA 可以直接读取和操作 WSL 内的文件与代码。不过目前该模式存在一个已知 Bug，暂时无法正常使用，下面截图展示了报错过程。

注意：此方式无需在 WSL 中安装 IDEA 程序。

3.3 关闭原生 WSL 集成模式

如果之前开启过原生集成模式，建议手动关闭。操作路径：进入设置页面 → 找到 WSL 集成相关选项 → 取消勾选原生集成模式 → 保存设置并重启 IDEA。

3.4 恢复界面为英文 → 禁用中文插件

4. 在 WSL 文件系统中创建新项目

官方文档对 WSL 项目创建有详细说明，下面结合截图走一遍完整流程。

4.1 配置 JDK

选择 WSL 环境中已安装的 JDK 路径，确认版本与项目兼容即可。

4.2 配置 Maven

4.3 运行类配置

4.4 打开终端 Terminal

5. 在 IDEA 中运行 OpenCode

5.1 将终端面板移到右侧

5.2 将终端改为独立窗口

结尾

以上就是基于 WSL 搭建 IDEA 远程开发环境的完整流程。配置完成后，你就能在 Windows 上享受纯终端 + IDEA 远程开发的流畅体验。

参考资料
[1] IDEA官方issue: youtrack.jetbrains.com/issue/IJPL-…
[2] IDEA官网下载页面: www.jetbrains.com/idea/downlo…