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

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

使用限制

當(dāng)前僅支持 WSL 2，暫不支持 WSL 1。

前置條件

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

連接 WSL

1. 打開(kāi)遠(yuǎn)程資源管理器，然后在右上角選擇 WSL 連接目標(biāo)。

   

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

   

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

   

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

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

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

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

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

   

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

   

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

   

6. 打開(kāi)文件夾或克隆 Git 倉(cāng)庫(kù)進(jìn)行開(kāi)發(fā)。

斷開(kāi)與 WSL 的連接

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

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

  

快捷操作面板說(shuō)明

使用 Alt + Ctrl + O 快捷鍵可打開(kāi) WSL 快捷操作面板。

你可以在面板上進(jìn)行以下操作：

更多功能

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

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

管理插件

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

在 WSL 中打開(kāi)終端

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

遠(yuǎn)程調(diào)試

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