在 Windows 子系统 Linux (WSL) 中开发
Windows 子系统 Linux (WSL) 使您能够在 Windows 上无缝运行 Linux 环境。Trae 的远程开发功能进一步扩展了此功能，使您能够直接在本地 WSL 环境中编写、调试和运行代码。
WSL 远程开发提供接近原生 Linux 的开发体验，同时保持 Windows 的易用性。无论是构建服务器应用程序、进行嵌入式开发，还是在 Linux 环境中测试代码，WSL 远程开发都提供高效且一致的体验，无需虚拟机或双启动设置。
架构
Trae 中的 WSL 开发设置遵循以下架构：
- 本地 PC：运行带有 UI 扩展的 Trae 客户端
- WSL 发行版：运行带有工作区扩展、AI 后端、终端和调试器的 Trae 服务器
- 文件系统映射：WSL 文件系统映射到
/mnt/c以实现无缝访问
限制
目前仅支持 WSL 2，不支持 WSL 1。
先决条件
在 Trae 中设置 WSL 开发之前，请确保满足以下要求：
- 您的 PC 操作系统是 Windows
- 您熟悉 WSL。如果您是初学者，建议在使用前阅读官方文档学习 WSL
- 您已在 PC 上安装了 WSL 2。如果尚未安装，请参考官方文档完成安装
连接到 WSL
按照以下步骤将 Trae 连接到您的 WSL 环境：
步骤 1：打开远程资源管理器
- 打开远程资源管理器并在右上角选择 WSL 目标选项
步骤 2：添加 WSL 发行版
- 在 WSL 目标文本右侧，点击 +（添加发行版）按钮
- 出现 WSL 发行版选择面板
- 选择要安装的 WSL 发行版。当前可用的发行版有：
- Ubuntu 20.04 LTS
- Ubuntu 22.04 LTS
- Ubuntu 24.04 LTS
步骤 3：安装发行版
- Trae 开始安装选定的 WSL 发行版。您可以在终端面板上查看安装进度
注意：如果终端面板提示您创建账户和密码，请创建它们；否则，您只需等待安装完成。
步骤 4：连接到发行版
- 安装完成后，点击 WSL 目标文本右侧的刷新按钮
- 已安装的 WSL 发行版出现在列表中
- 将光标悬停在要连接的 WSL 发行版上，点击在新窗口中连接或在当前窗口中连接按钮，或者您可以右键点击此 WSL 发行版并在快捷菜单中选择连接方式
- Trae 开始连接到指定的 WSL 发行版。连接后，此 WSL 发行版的名称出现在左下角
- 打开文件夹或克隆 Git 仓库并开始编码
断开与 WSL 的连接
您可以通过两种方式断开与 WSL 的连接：
- 直接退出 Trae：下次打开时，系统会提示您首先完成远程连接
- 使用菜单：从顶部菜单栏中，选择文件 > 关闭远程连接
快速访问面板
您可以使用快捷键 Alt + Ctrl + O 打开快速访问面板。
在快速访问面板上，您可以：
| 操作 | 描述 |
|---|---|
| 1 | 点击连接到默认 WSL 发行版 |
| 2 | 点击选择要连接的 WSL 发行版 |
| 3 | 点击打开左侧的 WSL 操作面板 |
其他操作
设置默认 WSL 发行版
Trae 自动将第一个安装的 WSL 发行版设置为"默认发行版"。安装其他发行版后，您可以右键点击另一个 WSL 发行版，从快捷菜单中选择设置为默认发行版将其设置为默认发行版。
管理扩展
扩展可以在本地 UI/服务器或 WSL 内运行。在扩展商店的已安装列表中，您可以查看本地和 WSL 中安装的扩展，并根据需要管理它们。
在 WSL 中打开终端
从顶部菜单栏中，选择终端 > 新建终端以打开在 WSL 中运行的终端，然后执行您的命令。
在 WSL 中调试
连接到 WSL 后，您可以使用 Trae 的调试功能，这与本地调试类似。您需要在 launch.json 文件中选择启动配置并按 F5 开始调试。应用程序将在远程主机上启动，调试器将附加到它。