文档首页/华为云码道（CodeArts）代码智能体/用户指南/远程开发/WSL发行版
更新时间：2026-03-20 GMT+08:00
查看PDF
分享

WSL发行版

华为云码道IDE支持远程连接WSL（Windows Subsystem for Linux）。该功能将本地WSL环境作为远程开发后端，使用户能够在Windows系统上，以连接远程服务器的方式，在本地WSL环境中进行全链路的代码编写、调试与运行。

图1 远程连接WSL

约束与限制

表1 约束与限制

限制类别

具体限制

功能限制

当前仅支持在华为云码道IDE工具中使用。

WSL

WSL已在本地Windows系统上成功安装。

系统版本

  • glibc >=2.18 
    # 查看glibc版本命令
ldd --version
  • glibcxx >=3.4.22 
    # 查看glibcxx版本命令
  # Ubuntu
  strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX
  # openEuler
  strings /lib64/libstdc++.so.6 | grep GLIBCXX

连接WSL

  1. 参考IDE中操作，登录华为云码道。
  2. 单击IDE左侧菜单栏中的远程开发图标 ，打开远程开发页面。
  3. 在WSL发行版中，华为云码道IDE会自动检测并识别当前系统中存在的WSL环境。

    图2 显示WSL环境信息

  4. 将鼠标悬浮在待连接的WSL环境上，单击 ，等待连接完成。

    等待连接完成，如果没有出现任何报错提示，且左下角状态栏已显示连接信息，表示连接成功。
    图3 连接完成

  5. 连接成功后，在资源管理器中单击“打开文件夹”，浏览并选中WSL环境上的目标文件夹，单击“确定”，即可打开目标文件夹。

    图4 打开目标文件夹

管理WSL连接

  • 关闭远程连接：在华为云码道IDE的远程开发中，将鼠标悬浮在已连接的WSL环境上，单击 ，即可关闭该连接。连接关闭后，如果需要再次连接，可单击 ，重新进行连接。
    图5 关闭连接
  • 在WSL中打开文件夹：在华为云码道IDE的远程开发中，将鼠标悬浮在已连接的WSL环境上，单击 ，选择对应的文件夹，即可在当前WSL环境中打开该文件夹。
    图6 打开WSL中的文件夹
  • 显示远程主机进程：在华为云码道IDE的远程开发中，将鼠标悬浮在已连接的WSL环境上，单击 ，可查看远程主机的进程信息。
    图7 查看远程主机进程

其他操作

图8 其他操作
表2 其他操作

操作

说明

重新加载当前WSL发行版列表或状态。

展开WSL发行版下的所有层级结构，取消所有折叠的子节点，便于用户快速浏览和管理大量连接项。

收起所有展开的WSL发行版，减少层级显示，提升界面可读性与操作效率。

显示/隐藏检测到的CodeArts项目

控制是否显示IDE自动检测到的与华为云CodeArts相关的远程项目和连接信息。

与本地扩展同步

触发一次同步操作，将当前的WSL发行版环境配置与某个“本地扩展”进行同步。通常用于保证插件或扩展能够正确识别并使用最新的WSL发行版连接信息，避免因配置不一致导致的连接问题，提升使用稳定性与一致性。

显示连接日志

查看WSL发行版连接的详细日志。当连接失败或出现异常时，可以通过日志排查问题和定位原因。

设置日志级别

调整WSL发行版连接日志的详细级别，如Trace、Debug和Info（默认为Info）。

帮助文档

打开官方帮助文档，获取关于WSL发行版配置和基础操作的详细指南。

父主题： 远程开发

相关文档