Visual Studio Code 常見問題集

我們的文件在特定主題中會視需要包含常見問題章節。我們在此處擷取不屬於其他主題的項目。

如果您在此處找不到問題的解答，請查看我們先前在 GitHub 上回報的問題和我們的版本資訊。

Visual Studio Code 和 Visual Studio IDE 之間有何差異？

Visual Studio Code 是一款精簡的程式碼編輯器，支援偵錯、工作執行和版本控制等開發作業。其目標是提供開發人員在快速程式碼建置-偵錯週期中所需的工具，並將更複雜的工作流程留給功能更完整的 IDE，例如 Visual Studio IDE。

VS Code 是否免費？

是，VS Code 可供私人或商業用途免費使用。如需詳細資訊，請參閱產品授權。

如果您尚未訂閱 Copilot，您可以註冊 Copilot Free 方案，免費使用 Copilot，並獲得每月完成和聊天互動的次數限制。

平台支援

支援哪些作業系統？

VS Code 可在 macOS、Linux 和 Windows 上執行。如需支援的版本，請參閱需求文件。您可以在設定總覽中找到更多平台特定詳細資訊。

我可以在較舊的 Windows 版本上執行 VS Code 嗎？

Microsoft 已終止支援且不再為 Windows 7、Windows 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 具有可攜式模式，可讓您將設定和資料保留在與安裝相同的位置，例如 USB 磁碟機上。

遙測和當機報告

如何停用遙測報告

VS Code 收集使用狀況資料並傳送給 Microsoft，以協助改善我們的產品和服務。閱讀我們的隱私權聲明和遙測文件以深入了解。

如果您不想將使用狀況資料傳送給 Microsoft，您可以將 telemetry.telemetryLevel 使用者設定設定為 off。

從 檔案 > 喜好設定 > 設定中，搜尋 telemetry，並將 遙測: 遙測層級 設定設為 off。這會讓 VS Code 停止傳送所有遙測事件。

重要注意事項：VS Code 可讓您選擇安裝 Microsoft 和協力廠商擴充功能。這些擴充功能可能會收集自己的使用狀況資料，且不受 telemetry.telemetryLevel 設定控制。請參閱特定擴充功能的文件，以了解其遙測報告。

如何停用實驗

VS Code 使用實驗來嘗試新功能或逐步推出這些功能。我們的實驗架構會呼叫 Microsoft 擁有的服務，因此在停用遙測時會停用。不過，如果您想要停用實驗，無論您的遙測喜好設定為何，您可以將 workbench.enableExperiments 使用者設定設定為 false。

從 檔案 > 喜好設定 > 設定中，搜尋 experiments，並取消核取 工作台: 啟用實驗 設定。這會防止 VS Code 呼叫服務，並退出任何進行中的實驗。

如何停用當機報告

VS Code 收集有關發生的任何當機的資料，並將其傳送給 Microsoft，以協助改善我們的產品和服務。閱讀我們的隱私權聲明和遙測文件以深入了解。

如果您不想將當機資料傳送給 Microsoft，您可以將 telemetry.telemetryLevel 使用者設定變更為 off。

從 檔案 > 喜好設定 > 設定中，搜尋 telemetry，並將 遙測: 遙測層級 設定設為 off。這會讓 VS Code 停止傳送所有遙測事件，包括當機報告。您需要重新啟動 VS Code，設定變更才會生效。

GDPR 和 VS Code

既然一般資料保護規範 (GDPR) 已生效，我們想要藉此機會重申，我們非常重視隱私權。這對 Microsoft 公司和 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 下取得。依語言 ID 本地化的 LICENSE.txt 版本位於 resources\app\licenses 下。

為什麼 Visual Studio Code 的授權與 vscode GitHub 存放庫的授權不同？

若要了解為什麼 Visual Studio Code 產品的授權與開放原始碼 vscode GitHub 存放庫 的授權不同，請參閱 issue #60 以取得詳細說明。

vscode 存放庫和 Microsoft Visual Studio Code 發行版本之間有何差異？

github.com/microsoft/vscode 存放庫 (Code - OSS) 是我們開發 Visual Studio Code 產品的地方。我們不僅在那裡撰寫程式碼和處理問題，還發布我們的藍圖和每月反覆運算和最後階段計畫。原始碼以標準 MIT 授權提供給所有人。

Visual Studio Code 是 Code - OSS 存放庫的發行版本，其中包含 Microsoft 特定自訂 (包括原始碼)，並以傳統 Microsoft 產品授權發行。

如需更多詳細資訊，請參閱Visual Studio Code 和「Code - OSS」差異文章。

「建置於開放原始碼之上」是什麼意思？

Microsoft Visual Studio Code 是 Microsoft 授權的 「Code - OSS」 發行版本，其中包含 Microsoft 專有資產 (例如圖示) 和功能 (Visual Studio Marketplace 整合、啟用遠端開發的小部分功能)。雖然這些新增項目僅佔整體發行版本程式碼基底的極小百分比，但更準確的說法是 Visual Studio Code 是「建置」於開放原始碼之上，而不是「是」開放原始碼，因為存在這些差異。如需每個發行版本包含哪些內容的詳細資訊，請參閱Visual Studio Code 和「Code - OSS」差異文章。

我如何找到擴充功能的授權？

大多數擴充功能會在 Marketplace 頁面或總覽章節中連結到其授權，當您在 [擴充功能] 檢視中選取擴充功能時。

例如

如果您找不到授權連結，您可能會在擴充功能的存放庫中找到授權 (如果它是公開的)，或者您可以透過 Marketplace 的問與答章節連絡擴充功能作者。

擴充功能

所有 VS Code 擴充功能都是開放原始碼嗎？

擴充功能作者可以自由選擇符合其業務需求的授權。雖然許多擴充功能作者選擇以開放原始碼授權發行其原始碼，但某些擴充功能 (例如 Wallaby.js、Google Cloud Code 和 VS Code 遠端開發擴充功能) 使用專有授權。

在 Microsoft，我們會盡可能開放原始碼我們的擴充功能。不過，依賴現有的專有原始碼或程式庫、跨入 Microsoft 授權工具或服務 (例如 Visual Studio) 的原始碼，以及 Microsoft 整體業務模型的差異，將導致某些擴充功能使用專有授權。您可以在Microsoft 擴充功能授權文章中找到 Microsoft 貢獻的 Visual Studio Code 擴充功能及其授權的清單。

我無法使用產品 X 存取擴充功能市集？

我們授權 Visual Studio Marketplace 供 Visual Studio 系列產品使用：Microsoft Visual Studio、Visual Studio Code、GitHub Codespaces、Azure DevOps、Azure DevOps Server，以及我們和 Microsoft 關係企業 (例如 GitHub, Inc. (「GitHub」)) 提供的後續產品和服務。

這很重要，原因如下：

• 擴充功能會在產品的內容和權限中執行，而且可能包含可執行程式碼。Marketplace 會審查每個擴充功能的安全性，並防止它們執行惡意活動。當您使用 Visual Studio 系列產品安裝擴充功能時，我們可以確保擴充功能在此內容中安全執行。

• 當回報和驗證惡意擴充功能，或在擴充功能相依性中發現弱點時，擴充功能會從 Marketplace 移除、新增至封鎖清單，並由 VS Code 自動解除安裝。

• Microsoft 花費大量資源來執行、維護和保護此全域線上服務。Visual Studio 系列產品保證能以安全可靠的方式存取 Marketplace，確保 Marketplace 在您需要時可用。

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

為什麼我應該從 Visual Studio Marketplace 安裝擴充功能？

從 Visual Studio Marketplace 安裝擴充功能比從其他來源安裝擴充功能有許多優點。

• Visual Studio Marketplace 採用多種機制來保護您免於安裝惡意擴充功能，包括惡意軟體掃描、動態偵測、發行者驗證等等。當您從不同來源安裝擴充功能時，無法保證擴充功能在您的內容中安全執行。

• 當回報和驗證惡意擴充功能，或在擴充功能相依性中發現弱點時，擴充功能會從 Marketplace 移除、新增至封鎖清單，並由 VS Code 自動解除安裝。

• Marketplace 可讓您輕鬆尋找、安裝和更新擴充功能。當有更新可用時 (例如因為安全性修正程式)，VS Code 會自動安裝更新的版本。

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

我無法使用產品 X 搭配 Microsoft 擴充功能？

我們使用 Microsoft VS Code 的官方開放原始碼發行版本測試 Microsoft 擴充功能。我們無法保證它們能在來自其他方的發行版本中正常運作。請務必查看擴充功能的授權，以取得有關可在哪些產品中使用的特定條款和條件。

回報 VS Code 擴充功能的問題

如需錯誤、功能要求或連絡擴充功能作者，您應該使用 Visual Studio Code Marketplace 中提供的連結，或使用命令面板中的 說明: 回報問題。不過，如果擴充功能有不遵守我們的行為準則的問題 (例如，包含褻瀆、色情內容或對使用者構成風險)，我們有 電子郵件別名可回報問題。收到郵件後，我們的 Marketplace 團隊將研究適當的行動方案，包括取消發布擴充功能。

VS Code 版本

我如何找到目前的 VS Code 版本？

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

在 macOS 上，移至 Code > 關於 Visual Studio Code。

在 Windows 和 Linux 上，移至 說明 > 關於。

VS Code 版本是列出的第一個 版本 號碼，且版本格式為「主要版本.次要版本.發行版本」，例如「1.27.0」。

先前的發行版本

您可以在版本發行資訊頂端找到一些發行版本下載的連結

如果您需要未列出的安裝類型，您可以透過下列 URL 手動下載

在 {version} 預留位置中取代您想要的特定發行版本。例如，若要下載 1.83.1 版的 Linux Arm64 debian 版本，您會使用

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

如果您想要永遠下載最新的 VS Code 穩定版本，可以使用版本字串 latest。

Windows 32 位元版本

在 1.83 版之後，不再主動支援 Windows x86 32 位元版本，而且可能會造成安全性風險。

預先發行版本

想要搶先預覽 VS Code 新功能嗎？您可以安裝「Insiders」組建，試用 VS Code 的預先發行版本。Insiders 組建會與您的穩定 VS Code 安裝並排安裝，並具有隔離的設定、組態和擴充功能。Insiders 組建會每晚更新，因此您將獲得前一天的最新錯誤修正和功能更新。

若要安裝 Insiders 組建，請移至 Insiders 下載頁面。

我如何退出 VS Code 自動更新？

預設情況下，當我們發行新更新時，VS Code 會設定為針對 macOS 和 Windows 使用者自動更新。如果您不想要取得自動更新，您可以將 更新: 模式 設定從 預設 變更為 無。

若要修改更新模式，請移至 檔案 > 喜好設定 > 設定，搜尋 update mode，並將設定變更為 無。

如果您使用 JSON 編輯器來設定設定，請新增下列程式碼行

    "update.mode": "none"

您可以解除安裝目前的 VS Code 版本，然後安裝特定版本資訊頁面頂端提供的下載，藉此安裝先前發行的 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 環境失敗

本節僅適用於 macOS 和 Linux 環境。

當從終端機啟動 VS Code 時 (例如，透過 code .)，它可以存取在您的 .bashrc 或 .zshrc 檔案中定義的環境設定。這表示工作或偵錯目標等功能也可以存取這些設定。

不過，當從您平台的使用者介面啟動時 (例如，macOS Dock 中的 VS Code 圖示)，您通常不會在 Shell 的內容中執行，而且您無法存取這些環境設定。這表示根據您啟動 VS Code 的方式，您可能沒有相同的環境。

為了解決這個問題，當透過 UI 手勢啟動時，VS Code 會啟動一個小型處理序來執行 (或「解析」) 在您的 .bashrc 或 .zshrc 檔案中定義的 Shell 環境。如果在可設定的逾時時間之後 (透過 application.shellEnvironmentResolutionTimeout，預設為 10 秒)，Shell 環境仍未解析，或因任何其他原因而解析失敗，VS Code 將會中止「解析」處理序，在沒有 Shell 環境設定的情況下啟動，而且您會看到類似以下的錯誤

如果錯誤訊息指出解析您的 Shell 環境花費的時間過長，下列步驟可以協助您調查可能是什麼原因造成速度緩慢。您也可以透過設定 application.shellEnvironmentResolutionTimeout 設定來增加逾時時間。但請記住，增加此值表示您必須等待更長的時間才能使用 VS Code 中的某些功能，例如擴充功能。

如果您看到其他錯誤，請建立 issue 以取得協助。

調查 Shell 初始化速度緩慢

以下概述的處理序可能協助您識別 Shell 初始化的哪些部分花費最多時間

• 開啟 Shell 的啟動檔案 (例如，在 VS Code 中，在 [快速開啟] 中輸入 ~/.bashrc 或 ~/.zshrc (⌘P (Windows、Linux Ctrl+P)))。
• 選擇性地註解掉可能長時間執行的作業 (例如，如果您找到 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 儲存庫 中提交問題和功能請求。

如果您想聯繫專業的支援工程師，您可以向 Microsoft 協助支援團隊 開立支援單。