问题背景:非vscode无法直接使用remote-wsl插件

WSL是个好东西,在windows系统上用过vscode的老铁都知道,我们可以通过remote-wsl插件实现WSL的快速连接。
但是随着基于vscode各种IDE如雨后春笋般出现,(Lingma IDE(通义灵码IDE)、Trae、Trae国际版、Cursor、腾讯 Tencent CodeBuddy、Baidu Comate、阿里 Qoder等基于VSCode的AI IDE中连接WSL却成了大难问题。因为remote-wsl插件从0.104.0版本开始就只支持在VSCode上运行了,不再支持其它改版IDE。
在这里插入图片描述
如上图所示,应用市场中提示: 暂不支持安装,可前往 VS Code 扩展市场 下载安装包。

记下来,就以Lingma IDE(通义灵码IDE)为例,将解决WSL连接问题的经验和方案,分享出来,供大家参考。

尝试1:手动下载安装最新版(失败)

在这里插入图片描述
在vscode应用商店,找到wsl插件,点击设置 - 下载VSIX 可以下载当前版本的vsix离线包。目前我下载得到的是ms-vscode-remote.remote-wsl-0.104.2.vsix
在这里插入图片描述
将其手动安装到Lingma IDE,会报错提示:
在这里插入图片描述
无法安装使用。。。

尝试2:回退安装0.99.0版本(失败)

在这里插入图片描述
新版本用不了,尝试下载旧版本。先尝试了ms-vscode-remote.remote-wsl-0.99.0.vsix版本。
在这里插入图片描述
如上图所示,可以安装。但是远程资源管理器看不到本地的wsl target,尝试刷新会报错:

运行命令 remote-wsl.explorer.refresh 错误: command 'remote-wsl.explorer.refresh' not found。这可能是由提交 remote-wsl.explorer.refresh 的扩展引起的。

尝试3:回退安装0.88.3版本(成功)

在这里插入图片描述
一路回退,直到ms-vscode-remote.remote-wsl-0.88.3.vsix版本(点击下载),可以看到wsl target了,有希望,尝试连接。
在这里插入图片描述
成功!!!

尝试4:使用remote-ssh方式替代wsl(成功)

直连wsl的方式虽然成功了,但是不保证随着版本更新不会失效。所以我们可以借助remote-ssh插件,使用ssh连接到本地wsl环境的这种折中方案来取代直连wsl。方法也很简单:

  • 第一步:在wsl中安装openssh-server,命令如下:

    sudo apt update
    sudo apt install openssh-server
    
  • 第二步:手动连接验证ssh,命令如下:

$ ssh localhost
The authenticity of host 'localhost (127.0.0.1)' can't be established.
ED25519 key fingerprint is SHA256:gP8svK1dSlmS2bWLMmsXBBo41vMAWkKLDQdt5qwc/nE.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added 'localhost' (ED25519) to the list of known hosts.
gyl@localhost's password:
Welcome to Ubuntu 24.04.2 LTS (GNU/Linux 6.6.87.2-microsoft-standard-WSL2 x86_64)

 * Documentation:  https://help.ubuntu.com
 * Management:     https://landscape.canonical.com
 * Support:        https://ubuntu.com/pro

 System information as of Sat Sep 20 11:23:38 CST 2025

  System load:  0.17                Processes:             70
  Usage of /:   2.7% of 1006.85GB   Users logged in:       1
  Memory usage: 9%                  IPv4 address for eth0: 172.22.210.54
  Swap usage:   0%

 * Strictly confined Kubernetes makes edge and IoT secure. Learn how MicroK8s
   just raised the bar for easy, resilient and secure K8s cluster deployment.

   https://ubuntu.com/engage/secure-kubernetes-at-the-edge

在这里插入图片描述

使用当前用户名登录到本机,输入密码(首次登录,在输入密码前会有一个是否连接的询问,输入yes回车即可)之后如果登录成功,则表示openssh-server安装配置成功,服务也成功启动。

  • 第三步:
    Lingma IDE的远程资源管理器,找到SSH TARGETS,点击+号,在打开的config文件最后,添加一个新的ssh服务器配置即可:
Host wsl
	HostName 127.0.0.1
	User alex

如下图所示,添加完成之后,保存关闭config,点击SSH TARGETS右侧的刷新按钮,就可以看到刚刚添加的wsl了。
在这里插入图片描述

  • 第四步:测试连接
    首先,点击wsl右侧的连接按钮
    在这里插入图片描述
    然后,输入ssh的密码
    在这里插入图片描述

最后,通过ssh连接到wsl成功,可以看到wsl的终端了。
在这里插入图片描述
之后,按照你熟悉的方式开发就行了。Enjoy!

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐