參加你附近的 ,瞭解 VS Code 中的 AI 輔助開發。

Visual Studio Code 常見問題解答

我們的文件會根據特定主題的需要包含一個常見問題部分。我們在此處收錄了不適合其他主題的內容。

如果在此處沒有找到您問題的答案,請檢視我們之前在 GitHub 上報告的問題以及我們的發行說明

在 VS Code 中開源 AI

我們已在 MIT 許可下開源了 GitHub Copilot Chat 擴充套件,並正在將相關元件引入 VS Code 核心。請在我們的公告部落格文章第一個里程碑更新中閱讀所有詳細資訊。

這會影響我當前的 GitHub Copilot 訂閱嗎?GitHub Copilot 現在是免費的嗎?

此更改不會影響當前的 GitHub Copilot 訂閱。要使用 GitHub Copilot,您仍需要一個 GitHub 帳戶,並擁有 GitHub Copilot 訂閱的訪問許可權。

無法透過組織或企業訪問 Copilot 的個人開發者可以訪問 GitHub Copilot 免費計劃可能存在限制)。如果該計劃不能滿足您的需求,您可以註冊 Copilot 付費計劃或自帶模型金鑰

GitHub Copilot 後端服務也會開源嗎?

GitHub Copilot 服務不受影響,將保持閉源狀態。

時間線是怎樣的?我什麼時候可以為 VS Code 中的 AI 體驗做出貢獻?

我們已經完成了此過程的第一步,即開源 GitHub Copilot Chat 擴充套件。原始碼可在 microsoft/vscode-copilot-chat 倉庫中找到。

在接下來的幾個月裡,我們將把 Copilot Chat 擴充套件的相關元件引入到核心的 VS Code 倉庫中。請檢視我們的計劃項以獲取有關時間線的詳細資訊和更新。

我們的目標是使為我們的 AI 功能做貢獻的體驗與為 VS Code 的任何其他部分做貢獻一樣簡單。作為其中的一部分,我們希望在貢獻時能夠使用 Copilot 後端服務進行除錯和測試。請檢視 CONTRIBUTING.md 檔案以獲取有關如何貢獻的詳細資訊。

為什麼要將 GitHub Copilot 整合到 VS Code 核心倉庫中?

自 GitHub Copilot 首次釋出以來,很明顯,AI 驅動的工具是我們編寫程式碼的核心方式。從使用遙測資料中,我們可以看到在 VS Code 中使用 AI 功能的使用者比使用除錯或測試等其他功能的使用者還要多。

將 AI 功能作為 VS Code 的核心部分,再次肯定了我們的信念:開放式工作可以為我們的使用者帶來更好的產品,並促進一個多樣化的擴充套件生態系統。

我是一名擴充套件作者。我將受到什麼影響?

我們保持對穩定 API 的向後相容性。您的擴充套件應該不會受到任何影響。我們會根據擴充套件作者的反饋不斷發展和擴充套件 VS Code 擴充套件 API。如果您需要額外的 API 來使您的擴充套件成功,我們很樂意聽取您的意見——請在 microsoft/vscode 倉庫中提交 API 請求。

我已經在 VS Code 中使用其他 AI 編碼擴充套件(Cline、Roo Code...)。這對我有什麼影響?

您可以繼續在 VS Code 中使用這些擴充套件!我們很高興社群正在構建擴充套件來改善 VS Code 中的開發者體驗。為了改善其他 AI 擴充套件的體驗,我們不斷新增 API,例如用於直接從擴充套件呼叫語言模型的語言模型 API,用於與語言模型工具互動並與內建或您自己的代理整合的工具 API,或用於執行和與終端命令互動的Shell 執行 API(對代理體驗特別有用)。展望未來,我們計劃新增更多 API 以滿足擴充套件作者的需求。

這會改變你們收集資料的方式嗎?

不,沒有任何改變。透過開源 GitHub Copilot Chat,我們完全透明地展示了我們如何收集資料,並使您能夠在原始碼中進行驗證。瞭解更多關於 VS Code 中的遙測GitHub Copilot 信任中心的資訊。

VS Code 團隊在未來的版本中將如何平衡 AI 功能和非 AI 功能的優先順序?

我們相信 AI 驅動的工具是我們編寫程式碼的核心方式。我們同時投資於 AI 功能和改進核心編輯器體驗。這也反映在團隊中,有 50% 的人從事 AI 相關工作,另外 50% 從事其他功能。許多非 AI 功能可能並不總是那麼顯而易見,例如效能、安全性、可訪問性、Electron 更新等。

將 AI 功能引入 VS Code 核心倉庫會影響 VS Code 的(啟動)效能嗎?

效能是我們的核心優先事項,我們致力於在整合 AI 功能的同時保持 VS Code 的效能。此外,如果您不在 VS Code 中啟用 AI 功能,任何相關的後臺程序都不會執行,因此不會影響效能。

我可以在 VS Code 中停用 AI 功能嗎?

您可以使用 chat.disableAIFeatures 設定在 VS Code 中停用內建的 AI 功能,這與您在 VS Code 中配置其他功能的方式類似。這將停用並隱藏 VS Code 中的聊天或內聯建議等功能,並停用 Copilot 擴充套件。您可以在工作區或使用者級別配置此設定。

或者,從標題欄的聊天選單中使用瞭解如何隱藏 AI 功能操作來訪問此設定。

注意

如果您之前已停用內建 AI 功能,在更新到新版本的 VS Code 時,您的選擇將得到尊重。

如果我在 VS Code 中停用 AI 功能,我的資料還會發送給微軟嗎?

不,如果您在 VS Code 中停用 AI 功能,或者您沒有從 VS Code 登入您的 Copilot 訂閱,您的資料不會發送到 Copilot 後端服務。瞭解更多關於 VS Code 中的遙測GitHub Copilot 信任中心的資訊。

VS Code 在 Copilot 擴充套件中使用的模型是開源(OSS)的嗎?

不是。GitHub Copilot 使用的模型是單獨授權的,這一點沒有改變。事實上,這些模型大多數來自第三方,如 OpenAI、Anthropic 和 Google……

Visual Studio Code 和 Visual Studio IDE 有什麼區別?

Visual Studio Code 是一個精簡的程式碼編輯器,支援除錯、任務執行和版本控制等開發操作。它旨在為開發者提供快速編碼-構建-調試周期所需的工具,而將更復雜的工作流留給功能更全面的 IDE,例如 Visual Studio IDE

VS Code 是免費的嗎?

是的,VS Code 對個人或商業使用都是免費的。詳情請參閱產品許可證

如果你還沒有 Copilot 訂閱,可以透過註冊 Copilot 免費計劃 免費使用 Copilot,並獲得每月限量的補全和聊天互動次數。

平臺支援

支援哪些作業系統?

VS Code 可以在 macOS、Linux 和 Windows 上執行。有關支援的版本,請參閱需求文件。您可以在安裝概覽中找到更多特定平臺的詳細資訊。

我可以在舊版 Windows 上執行 VS Code 嗎?

微軟已終止對 Windows 7Windows 8 和 Windows 8.1 的支援,並且不再提供安全更新。從 1.71(2022年8月)開始的 VS Code 桌面版不再在 Windows 7 上執行,從 1.80(2023年6月)開始將不再在 Windows 8 和 8.1 上執行。您需要升級到更新的 Windows 版本才能使用更高版本的 VS Code。

VS Code 將不再在舊版 Windows 上提供產品更新或安全修復。VS Code 1.70.3 版是 Windows 7 使用者可用的最後一個版本,1.79 版將是 Windows 8 和 8.1 使用者可用的最後一個版本。您可以在 support.microsoft.com 瞭解更多關於升級 Windows 版本的資訊。

此外,隨著 Windows 10 版本 2004 的釋出,32 位 OEM 支援已被放棄。支援 Windows 32 位的最後一個穩定版 VS Code 是 1.83(2023年9月)。您需要更新到 64 位版本。

我可以在舊版 macOS 上執行 VS Code 嗎?

從 1.96 版(2024年11月)開始,VS Code 桌面版將棄用對 macOS Catalina(10.15 及更早版本)的支援。從 VS Code 1.98 版(2025年2月)開始,我們將停止在 macOS Catalina(10.15 及更早版本)上更新 VS Code。您需要升級到更新的 macOS 版本才能使用更高版本的 VS Code。

VS Code 將不再在 macOS Catalina(10.15 及更早版本)上提供產品更新或安全修復,VS Code 1.97 版將是 macOS Catalina(10.15及更早版本)可用的最後一個版本。您可以在 support.apple.com 瞭解更多關於升級 macOS 版本的資訊。

我可以在舊的 Linux 發行版上執行 VS Code 嗎?

從 VS Code 1.86.1 版(2024年1月)開始,VS Code 桌面版僅與基於 glibc 2.28 或更高版本的 Linux 發行版相容,例如 Debian 10、RHEL 8 或 Ubuntu 20.04。

如果您無法升級您的 Linux 發行版,推薦的替代方案是使用我們的網頁客戶端。如果您想使用桌面版,可以從這裡下載 VS Code 1.85 版。根據您的平臺,請確保停用更新以保持在該版本。一個好的建議是使用便攜模式進行安裝。

我可以執行 VS Code 的便攜版嗎?

是的,VS Code 有一個便攜模式,可以讓您將設定和資料儲存在與安裝位置相同的地方,例如在 U 盤上。

遙測和崩潰報告

如何停用遙測報告

VS Code 收集使用資料並將其傳送給微軟,以幫助改進我們的產品和服務。請閱讀我們的隱私宣告遙測文件以瞭解更多資訊。

如果您不想將使用資料傳送給微軟,可以將 telemetry.telemetryLevel 使用者設定off

檔案 > 首選項 > 設定,搜尋 telemetry,並將遙測: 遙測級別設定設為 off。這將使 VS Code 未來的所有遙測事件靜默。

重要提示:VS Code 為您提供了安裝微軟和第三方擴充套件的選項。這些擴充套件可能會收集它們自己的使用資料,並且不受 telemetry.telemetryLevel 設定的控制。請查閱特定擴充套件的文件以瞭解其遙測報告。

如何停用實驗

VS Code 使用實驗來嘗試新功能或逐步推出它們。我們的實驗框架會呼叫一個微軟擁有的服務,因此在停用遙測時它也會被停用。但是,如果您希望無論您的遙測偏好如何都停用實驗,您可以將 workbench.enableExperiments 使用者設定false

檔案 > 首選項 > 設定,搜尋 experiments,並取消選中工作臺: 啟用實驗設定。這將阻止 VS Code 呼叫該服務,並退出任何正在進行的實驗。

如何停用崩潰報告

VS Code 收集有關任何發生的崩潰的資料並將其傳送給微軟,以幫助改進我們的產品和服務。請閱讀我們的隱私宣告遙測文件以瞭解更多資訊。

如果您不想將崩潰資料傳送給微軟,可以將 telemetry.telemetryLevel 使用者設定更改為 off

檔案 > 首選項 > 設定,搜尋 telemetry,並將遙測: 遙測級別設定設為 off。這將使包括崩潰報告在內的所有來自 VS Code 的遙測事件靜默。您需要重新啟動 VS Code 才能使設定更改生效。

GDPR 和 VS Code

現在《通用資料保護條例》(GDPR)已生效,我們想借此機會重申,我們非常重視隱私。這既適用於作為一家公司的微軟,也特別適用於 VS Code 團隊。

為支援 GDPR

  • VS Code 產品會通知所有使用者,他們可以選擇退出遙測資料收集。
  • 團隊會積極審查和分類所有傳送的遙測資料(記錄在我們的 OSS 程式碼庫中)。
  • 對收集的任何資料,例如崩潰轉儲,都有有效的資料保留策略。

您可以在遙測文件中瞭解更多關於 VS Code 的 GDPR 合規性資訊。

VS Code 使用哪些線上服務?

除了崩潰報告和遙測,VS Code 還將線上服務用於各種其他目的,例如下載產品更新、查詢、安裝和更新擴充套件,或在設定編輯器中提供自然語言搜尋。您可以在管理線上服務中瞭解更多資訊。

您可以選擇開啟/關閉使用這些服務的功能。從檔案 > 首選項 > 設定,並輸入標籤 @tag:usesOnlineServices。這將顯示所有控制線上服務使用的設定,您可以單獨開啟或關閉它們。

許可

位置

您可以在 VS Code 安裝位置的 resources\app 資料夾下找到 VS Code 許可證、第三方宣告和 Chromium 開源致謝列表。VS Code 的 ThirdPartyNotices.txt、Chromium 的 Credits_*.html 和 VS Code 的英文版 LICENSE.txt 都在 resources\app 下。LICENSE.txt 的本地化版本按語言 ID 儲存在 resources\app\licenses 下。

為什麼 Visual Studio Code 的許可證與 vscode GitHub 倉庫的許可證不同?

要了解為什麼 Visual Studio Code 這個產品的許可證與開源的 vscode GitHub 倉庫的許可證不同,請參閱 問題 #60 獲取詳細解釋。

vscode 倉庫和微軟 Visual Studio Code 發行版有什麼區別?

github.com/microsoft/vscode 倉庫(Code - OSS)是我們開發 Visual Studio Code 產品的地方。我們不僅在那裡編寫程式碼和處理問題,還發布我們的路線圖以及每月的迭代和收尾計劃。原始碼在標準的 MIT 許可證下對所有人開放。

Visual Studio Code 是 Code - OSS 倉庫的一個發行版,帶有微軟特定的定製(包括原始碼),在傳統的微軟產品許可證下發布。

更多詳細資訊,請參閱Visual Studio Code 和 'Code - OSS' 的區別一文。

“基於開源構建”是什麼意思?

Microsoft Visual Studio Code'Code - OSS' 的一個微軟許可發行版,它包含了微軟的專有資產(如圖示)和功能(Visual Studio Marketplace 整合,啟用遠端開發的小部分功能)。雖然這些新增內容在整個發行版程式碼庫中只佔很小的一部分,但由於這些差異,說 Visual Studio Code 是“基於”開源構建的,比說它“是”開源的更準確。有關每個發行版包含內容的更多資訊,可以在Visual Studio Code 和 'Code - OSS' 的區別一文中找到。

擴充套件

所有的 VS Code 擴充套件都是開源的嗎?

擴充套件作者可以自由選擇適合其業務需求的許可證。雖然許多擴充套件作者選擇在開源許可下發布其原始碼,但一些擴充套件如 Wallaby.jsGoogle Cloud Code 以及 VS Code 遠端開發擴充套件使用專有許可證。

在微軟,我們混合使用了開源和閉源擴充套件。依賴現有的專有原始碼或庫、涉及微軟許可工具或服務的原始碼(例如,C# DevKit 擴充套件使用 Visual Studio 訂閱許可模式,請參閱許可證),以及整個微軟的商業模式差異,都可能導致擴充套件選擇專有許可證。您可以在微軟擴充套件許可證一文中找到微軟貢獻的 Visual Studio Code 擴充套件及其原始碼許可證的列表。

我如何找到一個擴充套件的許可證?

大多數擴充套件都會在其 Marketplace 頁面(其“自述檔案”文件)上提供許可證連結,位於右側欄的資源下。如果您沒有找到連結,如果擴充套件的倉庫是公開的,您可能會在其中找到許可證,或者您可以透過 Marketplace 的問答部分聯絡擴充套件作者。

我可以在 VS Code 之外使用微軟的擴充套件嗎?

不可以。雖然微軟擴充套件的原始碼可能是開源的,但我們不授權在 Visual Studio 系列產品之外使用從 Visual Studio Marketplace 釋出和獲取的微軟或其關聯公司的擴充套件。這些產品包括:Microsoft Visual Studio、Visual Studio Code、GitHub Codespaces、Azure DevOps、Azure DevOps Server,以及我們和微軟關聯公司(如 GitHub, Inc.)提供的後續產品和服務。我們只在 Visual Studio 系列產品中構建、測試、部署和支援這些擴充套件和服務,以確保它們符合我們的安全和質量標準。我們不會為其他地方的擴充套件這樣做,包括那些基於 Code - OSS 倉庫分支構建的擴充套件。更多資訊請參閱 Visual Studio Marketplace 服務條款中的條件:Marketplace/NuGet 產品的用權

我無法從 <<此處填寫產品名>> 訪問 Visual Studio Marketplace,為什麼?

我們提供的 Visual Studio Marketplace 僅供 Visual Studio 系列產品使用:Microsoft Visual Studio、Visual Studio Code、GitHub Codespaces、Azure DevOps、Azure DevOps Server,以及我們和微軟關聯公司(如 GitHub, Inc.)提供的後續產品和服務。因此,包括那些基於 Code - OSS 倉庫分支構建的替代產品,不允許訪問 Visual Studio Marketplace。我們這樣做是為了保護生態系統的安全和質量,包括以下措施:

  • 擴充套件在產品的上下文中執行並擁有其許可權,並且可能包含可執行程式碼。Marketplace 會對每個擴充套件進行審查以確保安全並防止其執行惡意活動。當您在 Visual Studio 系列產品中安裝擴充套件時,您知道它已經過審查,可以在該上下文中執行。

  • 當報告並驗證了惡意擴充套件,或在擴充套件依賴項中發現漏洞時,該擴充套件將從 Marketplace 中移除,新增到阻止列表中,並由 VS Code 自動解除安裝。

  • 微軟投入了大量資源來執行、維護和保護這個全球線上服務。Visual Studio 系列產品旨在以安全可靠的方式訪問 Marketplace,以便在您需要時 Marketplace 始終可用。

  • 擴充套件可能會與產品深度整合。Marketplace 確保我們維護 API 相容性,並確保擴充套件正確使用產品的擴充套件 API。這有助於確保您安裝的擴充套件在版本更新後仍能正常工作。

有關此主題的更多詳細資訊,請參閱 #31168

為什麼我應該從 Visual Studio Marketplace 安裝擴充套件?

從 Visual Studio Marketplace 安裝擴充套件比從其他來源安裝有許多優勢。

  • Visual Studio Marketplace 採用多種機制來保護您免受惡意擴充套件的侵害,包括惡意軟體掃描、動態檢測、釋出者驗證等。當您從其他來源安裝擴充套件時,無法保證該擴充套件在您的環境中是安全的。

  • 當報告並驗證了惡意擴充套件,或在擴充套件依賴項中發現漏洞時,該擴充套件將從 Marketplace 中移除,新增到阻止列表中,並由 VS Code 自動解除安裝。

  • Marketplace 使您能夠輕鬆地查詢、安裝和更新擴充套件。當有可用更新時,例如因為安全修復,VS Code 會自動安裝更新後的版本。

  • 擴充套件可能會與產品深度整合。Marketplace 確保我們維護 API 相容性,並確保擴充套件正確使用產品的擴充套件 API。這有助於確保您安裝的擴充套件在版本更新後仍能正常工作。

報告 VS Code 擴充套件的問題

對於錯誤、功能請求或聯絡擴充套件作者,您應該使用 Visual Studio Code Marketplace 中提供的連結,或從命令面板中使用幫助: 報告問題。但是,如果某個擴充套件不遵守我們的行為準則,例如包含褻瀆、色情內容或對使用者構成風險,我們有一個電子郵件別名來報告該問題。收到郵件後,我們的 Marketplace 團隊將研究適當的行動方案,包括但不限於下架該擴充套件。

VS Code 版本

我如何找到我當前的 VS Code 版本?

您可以在“關於”對話方塊中找到 VS Code 的版本資訊。

在 macOS 上,轉到 Code > 關於 Visual Studio Code

在 Windows 和 Linux 上,轉到幫助 > 關於

VS Code 版本是列出的第一個版本號,其格式為“主版本號.次版本號.修訂號”,例如“1.100.0”。

以前的版本

您可以在某個版本的發行說明頂部找到一些發行版下載連結

Download links in release notes

如果您需要那裡未列出的安裝型別,您可以透過以下 URL 手動下載

下載型別 URL
Windows x64 系統安裝程式 https://update.code.visualstudio.com/{version}/win32-x64/stable
Windows x64 使用者安裝程式 https://update.code.visualstudio.com/{version}/win32-x64-user/stable
Windows x64 zip https://update.code.visualstudio.com/{version}/win32-x64-archive/stable
Windows x64 CLI https://update.code.visualstudio.com/{version}/cli-win32-x64/stable
Windows Arm64 系統安裝程式 https://update.code.visualstudio.com/{version}/win32-arm64/stable
Windows Arm64 使用者安裝程式 https://update.code.visualstudio.com/{version}/win32-arm64-user/stable
Windows Arm64 zip https://update.code.visualstudio.com/{version}/win32-arm64-archive/stable
Windows Arm64 CLI https://update.code.visualstudio.com/{version}/cli-win32-arm64/stable
macOS 通用版 https://update.code.visualstudio.com/{version}/darwin-universal/stable
macOS Intel 晶片 https://update.code.visualstudio.com/{version}/darwin/stable
macOS Intel 晶片 CLI https://update.code.visualstudio.com/{version}/cli-darwin-x64/stable
macOS Apple 晶片 https://update.code.visualstudio.com/{version}/darwin-arm64/stable
macOS Apple 晶片 CLI https://update.code.visualstudio.com/{version}/cli-darwin-arm64/stable
Linux x64 https://update.code.visualstudio.com/{version}/linux-x64/stable
Linux x64 debian https://update.code.visualstudio.com/{version}/linux-deb-x64/stable
Linux x64 rpm https://update.code.visualstudio.com/{version}/linux-rpm-x64/stable
Linux x64 snap https://update.code.visualstudio.com/{version}/linux-snap-x64/stable
Linux x64 CLI https://update.code.visualstudio.com/{version}/cli-linux-x64/stable
Linux Arm32 https://update.code.visualstudio.com/{version}/linux-armhf/stable
Linux Arm32 debian https://update.code.visualstudio.com/{version}/linux-deb-armhf/stable
Linux Arm32 rpm https://update.code.visualstudio.com/{version}/linux-rpm-armhf/stable
Linux Arm32 CLI https://update.code.visualstudio.com/{version}/cli-linux-armhf/stable
Linux Arm64 https://update.code.visualstudio.com/{version}/linux-arm64/stable
Linux Arm64 debian https://update.code.visualstudio.com/{version}/linux-deb-arm64/stable
Linux Arm64 rpm https://update.code.visualstudio.com/{version}/linux-rpm-arm64/stable
Linux Arm64 CLI https://update.code.visualstudio.com/{version}/cli-linux-arm64/stable

{version} 佔位符替換為您想要的特定版本。例如,要下載 1.83.1 的 Linux Arm64 debian 版本,您將使用

https://update.code.visualstudio.com/1.83.1/linux-deb-arm64/stable

如果您想始終下載最新的 VS Code 穩定版,可以使用版本字串 latest

Windows 32 位版本

Windows x86 32 位版本在 1.83 版釋出後不再積極支援,並可能存在安全風險。

下載型別 URL
Windows x86 系統安裝程式 https://update.code.visualstudio.com/{version}/win32/stable
Windows x86 使用者安裝程式 https://update.code.visualstudio.com/{version}/win32-user/stable
Windows x86 zip https://update.code.visualstudio.com/{version}/win32-archive/stable
Windows x86 CLI https://update.code.visualstudio.com/{version}/cli-win32-ia32/stable

預釋出版本

想提前一睹 VS Code 的新功能嗎?您可以透過安裝“Insiders”版本來試用 VS Code 的預釋出版本。Insiders 版本會與您的穩定版 VS Code 並行安裝,並具有獨立的設定、配置和擴充套件。Insiders 版本每晚更新,因此您將獲得前一天的最新錯誤修復和功能更新。

要安裝 Insiders 版本,請訪問 Insiders 下載頁面

如何選擇退出 VS Code 自動更新?

預設情況下,當我們在 macOS 和 Windows 使用者釋出新更新時,VS Code 會設定為自動更新。如果您不希望自動更新,可以將更新: 模式設定從 default 更改為 none

要修改更新模式,請轉到檔案 > 首選項 > 設定,搜尋 update mode 並將設定更改為 none

如果您使用 JSON 編輯器進行設定,請新增以下行

    "update.mode": "none"

您可以透過解除安裝當前版本,然後安裝特定發行說明頁面頂部提供的下載來安裝以前版本的 VS Code。

注意: 在 Linux 上:如果 VS Code 倉庫安裝正確,那麼您的系統包管理器應該會像處理系統上的其他包一樣處理自動更新。請參閱在 Linux 上安裝 VS Code

選擇退出擴充套件更新

預設情況下,當新版本可用時,VS Code 也會自動更新擴充套件。如果您不希望擴充套件自動更新,可以在設定編輯器中取消選中擴充套件: 自動更新複選框(⌘, (Windows, Linux Ctrl+,))。

如果您使用 JSON 編輯器修改您的設定,請新增以下行

    "extensions.autoUpdate": false

我在哪裡可以找到 Visual Studio Code 的圖示?

是否有使用圖示和名稱的指南?

您可以在圖示和名稱使用指南下載官方的 Visual Studio Code 圖示並閱讀使用指南。

什麼是 VS Code “工作區”?

VS Code 的“工作區”通常就是您的專案根資料夾。VS Code 使用“工作區”的概念來限定專案配置的範圍,例如專案特定的設定以及用於除錯任務的配置檔案。工作區檔案儲存在專案根目錄下的 .vscode 資料夾中。您還可以透過一個名為多根工作區的功能,在 VS Code 工作區中擁有多個根資料夾。

您可以在什麼是 VS Code “工作區”?一文中瞭解更多資訊。

問題和故障

安裝似乎已損壞 [不支援]

VS Code 會進行後臺檢查,以檢測安裝是否在磁碟上被更改,如果是,您將在標題欄中看到文字[不支援]。這樣做是因為一些擴充套件會直接修改(修補)VS Code 產品,這種方式是半永久性的(直到下次更新),這可能導致難以重現的問題。我們不是想阻止對 VS Code 進行修補,而是希望提高意識,即修補 VS Code 意味著您正在執行一個不受支援的版本。重新安裝 VS Code將替換被修改的檔案並消除此警告。

如果 VS Code 檔案被防毒軟體錯誤地隔離或刪除,您可能也會看到[不支援]的訊息(參見問題 #94858的示例)。請檢查您的防毒軟體設定並重新安裝 VS Code 以修復丟失的檔案。

解決 shell 環境失敗

當 VS Code 從終端啟動時(例如,透過 code .),它可以訪問您在 .bashrc.zshrc 檔案中定義的環境設定。這意味著像任務或除錯目標這樣的功能也可以訪問這些設定。

但是,當從您平臺的使用者介面啟動時(例如,macOS dock 中的 VS Code 圖示),您通常不是在 shell 的上下文中執行,並且無法訪問那些環境設定。這意味著,根據您啟動 VS Code 的方式,您可能沒有相同的環境。

為了解決這個問題,當透過 UI 手勢啟動時,VS Code 會啟動一個小程序來執行(或“解析”)您在 .bashrc.zshrc 或 PowerShell 配置檔案中定義的 shell 環境。如果在可配置的超時(透過 application.shellEnvironmentResolutionTimeout,預設為 10 秒)後,shell 環境仍未解析或因任何其他原因解析失敗,VS Code 將中止“解析”過程,在沒有您的 shell 環境設定的情況下啟動,並且您將看到類似以下的錯誤

Shell environment startup error

如果錯誤訊息指示解析您的 shell 環境花費了太長時間,下面的步驟可以幫助您調查可能導致緩慢的原因。您還可以透過配置 application.shellEnvironmentResolutionTimeout 設定來增加超時時間。但請記住,增加此值意味著您需要等待更長時間才能使用 VS Code 中的某些功能,例如擴充套件。

如果您看到其他錯誤,請建立一個問題以獲取幫助。

調查緩慢的 shell 初始化

下面概述的過程可以幫助您確定 shell 初始化的哪些部分花費了最多的時間

  • 開啟您的 shell 啟動檔案(例如,在 VS Code 中透過在快速開啟(⌘P (Windows, Linux Ctrl+P))中輸入 ~/.bashrc~/.zshrc)。
  • 選擇性地註釋掉可能長時間執行的操作(例如,如果您發現 nvm)。
  • 儲存並完全重啟 VS Code。
  • 繼續註釋掉操作,直到錯誤消失。

注意:雖然 nvm 是一個功能強大且有用的 Node.js 包管理器,但如果在 shell 初始化期間執行,它可能會導致 shell 啟動時間變慢。您可以考慮使用包管理器替代方案,如 asdf,或在網際網路上搜索 nvm 效能建議。

從終端啟動 VS Code

如果修改您的 shell 環境不切實際,您可以透過直接從一個完全初始化的終端啟動 VS Code 來避免 VS Code 的解析 shell 環境階段。

  • 在開啟的終端中輸入 code 將啟動 VS Code 並開啟您上次的工作區。
  • 輸入 code . 將啟動 VS Code 並開啟當前資料夾。

VS Code 變為空白?

Visual Studio Code 使用的 Electron shell 在某些 GPU(圖形處理單元)硬體加速方面存在問題。如果 VS Code 顯示一個空白(空)的主視窗,您可以在啟動 VS Code 時嘗試停用 GPU 加速,方法是新增 Electron --disable-gpu 命令列開關。

code --disable-gpu

如果這是在更新後發生的,刪除 GPUCache 目錄可以解決問題。

rm -r ~/.config/Code/GPUCache

開啟資料夾後,VS Code 立即變得無響應

當您開啟一個資料夾時,VS Code 會搜尋典型的專案檔案以為您提供額外的工具(例如,狀態列中的解決方案選擇器以開啟一個解決方案)。如果您開啟一個包含大量檔案的資料夾,搜尋可能會花費大量時間和 CPU 資源,在此期間 VS Code 可能會響應緩慢。我們計劃在未來改進這一點,但目前您可以透過 files.exclude 設定從資源管理器中排除資料夾,這樣它們就不會被搜尋專案檔案了

    "files.exclude": {
        "**/largeFolder": true
    }

技術支援渠道

您可以在 Stack Overflow 上提問和搜尋答案,並直接在我們的 GitHub 倉庫中提交問題和功能請求。

如果您想聯絡專業支援工程師,可以向微軟協助支援團隊提交工單。