# WSL发行版
华为云码道代码智能体IDE支持远程连接WSL（Windows Subsystem for Linux）。该功能将本地WSL环境作为远程开发后端，使用户能够在Windows系统上，以连接远程服务器的方式，在本地WSL环境中进行全链路的代码编写、调试与运行。
图1远程连接WSL   
![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002577501986.png "点击放大")
#### 约束与限制
表1约束与限制 
| 限制类别 | 具体限制                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|
| 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 ```    |
| 网页预览 | 暂不支持通过"file:///"协议直接打开浏览器进行预览。                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
#### 连接WSL
1. 参考[快速启动](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0002.html)中操作，登录华为云码道代码智能体IDE。
2. 单击IDE左侧菜单栏中的远程开发图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002608141741.png)，打开远程开发页面。
3. 在WSL发行版中，华为云码道代码智能体IDE会自动检测并识别当前系统中存在的WSL环境。
4. 将鼠标悬浮在待连接的WSL环境上，单击 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002577501884.png)，等待连接完成。
   
   等待连接完成，如果没有出现任何报错提示，且左下角状态栏已显示连接信息，表示连接成功。
   
   
5. 连接成功后，在资源管理器中单击"打开文件夹"，浏览并选中WSL环境上的目标文件夹，单击"确定"，即可打开目标文件夹。
 
#### 管理WSL连接
表2管理WSL连接 
| 操作         | 操作指导                                                                                                                                                                                                                                                                      |
|:---|:---|
| 关闭远程连接     | 在华为云码道代码智能体IDE的远程开发中，将鼠标悬浮在已连接的WSL环境上，单击 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002662970807.png)，即可关闭该连接。连接关闭后，如果需要再次连接，可单击 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002632651612.png)，重新进行连接。 |
| 在WSL中打开文件夹 | 在华为云码道代码智能体IDE的远程开发中，将鼠标悬浮在已连接的WSL环境上，单击 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002662810861.png)，选择对应的文件夹，即可在当前WSL环境中打开该文件夹。                                                                                                       |
| 显示远程主机进程   | 在华为云码道代码智能体IDE的远程开发中，将鼠标悬浮在已连接的WSL环境上，单击 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002632491718.png)，可查看远程主机的进程信息。                                                                                                                     |
   
#### 其他操作
表3其他操作 
| 操作                                                                                             | 说明                                                                                                  |
|:---|:---|
| ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002577621946.png) | 重新加载当前WSL发行版列表或状态。                                                                                  |
| ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002608141827.png) | 展开WSL发行版下的所有层级结构，取消所有折叠的子节点，便于用户快速浏览和管理大量连接项。                                                       |
| ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002607981943.png) | 收起所有展开的WSL发行版，减少层级显示，提升界面可读性与操作效率。                                                                  |
| 显示/隐藏检测到的CodeArts项目                                                                            | 控制是否显示IDE自动检测到的与华为云CodeArts相关的远程项目和连接信息。                                                            |
| 与本地扩展同步                                                                                        | 触发一次同步操作，将当前的WSL发行版环境配置与某个"本地扩展"进行同步。通常用于保证插件或扩展能够正确识别并使用最新的WSL发行版连接信息，避免因配置不一致导致的连接问题，提升使用稳定性与一致性。 |
| 显示连接日志                                                                                         | 查看WSL发行版连接的详细日志。当连接失败或出现异常时，可以通过日志排查问题和定位原因。                                                        |
| 设置日志级别                                                                                         | 调整WSL发行版连接日志的详细级别，如Trace、Debug和Info（默认为Info）。                                                       |
| 帮助文档                                                                                           | 打开官方帮助文档，获取关于WSL发行版配置和基础操作的详细指南。                                                                    |