Trae 使用 WSL 開發(fā)：高效 Linux 環(huán)境配置指南

Windows Subsystem for Linux (WSL) 支持在 Windows 系統(tǒng)上無縫運行 Linux 環(huán)境，Trae CN 的遠程開發(fā)功能進一步擴展了這一能力，使你能夠像連接遠程服務(wù)器一樣，直接在本地 WSL 環(huán)境中編寫、調(diào)試和運行代碼。

WSL 遠程開發(fā)提供了接近原生 Linux 的開發(fā)體驗，同時保留了 Windows 的易用性。無論是構(gòu)建服務(wù)端應(yīng)用、嵌入式開發(fā)，還是需要在 Linux 環(huán)境下測試代碼，WSL 遠程開發(fā)都能提供高效、一致的開發(fā)體驗，無需虛擬機或雙系統(tǒng)。本文檔將介紹如何在 Trae CN 中配置和使用 WSL 進行遠程開發(fā)。

使用限制

當前僅支持 WSL 2，暫不支持 WSL 1。

前置條件

• PC 的操作系統(tǒng)為 Windows。
• 你已了解 WSL。若你是 WSL 的初學者，建議先閱讀 WSL 官方說明文檔進行了解。
• 你已在 PC 本地安裝 WSL 2。若未安裝，參考此文檔完成安裝。

連接 WSL

1. 打開遠程資源管理器，然后在右上角選擇 WSL 連接目標。

   

2. 在 WSL 連接目標 文案右側(cè)，點擊 +（添加發(fā)行版）按鈕。

   

   界面上顯示 WSL 發(fā)行版選擇面板。

   

3. 選擇你想安裝的 WSL 發(fā)行版。當前的可選項為 Ubuntu 20.04 LTS、Ubuntu 22.04 LTS 和 Ubuntu 24.04 LTS。

   Trae CN 開始安裝所選的 WSL 發(fā)行版。你可以在 終端 面板中查看安裝進度。

   提示
   若 終端 面板中提示你創(chuàng)建帳號和密碼，創(chuàng)建即可，否則直接等待安裝完成。

4. 安裝完成后，點擊 WSL 連接目標 文案右側(cè)的 刷新 按鈕。

   列表中顯示已安裝的 WSL 發(fā)行版。

   

5. 將鼠標懸浮至需連接的 WSL 發(fā)行版，然后點擊 在新窗口連接 或 在當前窗口連接 按鈕，或右擊該發(fā)行版，然后在快捷菜單中選擇。

   

   Trae CN 開始連接至指定的 WSL 發(fā)行版。連接完成后，界面左下角顯示已連接的 WSL 發(fā)行版。

   

6. 打開文件夾或克隆 Git 倉庫進行開發(fā)。

斷開與 WSL 的連接

• 直接退出 Trae CN，下次打開后會優(yōu)先提示你連接 WSL。

• 在頂部菜單欄中，選擇 文件 > 關(guān)閉遠程連接。

  

快捷操作面板說明

使用 Alt + Ctrl + O 快捷鍵可打開 WSL 快捷操作面板。

你可以在面板上進行以下操作：

更多功能

設(shè)置默認連接的 WSL 發(fā)行版

Trae CN 下載的第一個 WSL 發(fā)行版會被自動設(shè)置為 “默認 Distro”。下載更多發(fā)行版后，你可以右擊某個發(fā)行版，然后在快捷菜單中選擇 設(shè)置為默認 Distro。

管理插件

插件可分別在本地的 UI / 服務(wù)端，或 WSL 中運行。在插件市場的 已安裝 列表中，你可以查看本地和 WSL 中安裝的插件，然后按需管理它們。

在 WSL 中打開終端

在頂部菜單欄中，選擇 終端 > 新建終端，在 WSL 中打開終端，然后執(zhí)行所需命令。

遠程調(diào)試

連接到 WSL 后，可以使用 Trae CN 的調(diào)試功能，與本地調(diào)試類似。在 launch.json 文件中選擇啟動配置并按 F5 鍵開始調(diào)試，應(yīng)用程序?qū)⒃谶h程主機上啟動，調(diào)試器會附加到其中。