Visual Studio Code 常見問題集

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

如果您在此處沒有看到問題的解答，請查看我們先前在 GitHub 上回報的問題和我們的發行說明。

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

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

支援哪些作業系統？

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

VS Code 是免費的嗎？

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

如何停用遙測報告

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 自動更新？

根據預設，當我們發布新更新時，VS Code 會設定為針對 macOS 和 Windows 使用者自動更新。如果您不想取得自動更新，您可以將 更新: 模式 設定從 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

授權

位置

您可以在 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 存放庫的授權不同，請參閱 問題 #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 擴充功能及其授權的清單。

如何尋找版本？

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

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

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

VS Code 版本是列出的第一個 版本 號碼，且版本格式為「major.minor.release」，例如「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 下載頁面。

在哪裡可以找到 Visual Studio Code 圖示？

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

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

什麼是 VS Code「工作區」？

VS Code「工作區」通常只是您的專案根資料夾。VS Code 使用「工作區」概念來限定專案組態的範圍，例如專案特定的設定，以及用於偵錯和工作的組態檔。工作區檔案儲存在專案根目錄的 .vscode 資料夾中。您也可以透過稱為多根目錄工作區的功能，在 VS Code 工作區中擁有多個根資料夾。

您可以在什麼是 VS Code「工作區」？文章中深入了解。

我可以執行 VS Code 的可攜式版本嗎？

是，VS Code 具有可攜式模式，可讓您將設定和資料保存在與安裝位置相同的位置，例如 USB 磁碟機上。

回報 VS Code 擴充功能的問題

對於錯誤、功能要求或聯絡擴充功能作者，您應該使用 Visual Studio Code Marketplace 中提供的連結，或使用命令選擇區中的 說明: 回報問題。但是，如果發生擴充功能未遵循我們的行為準則的問題，例如包含褻瀆性、色情內容或對使用者構成風險，那麼我們有電子郵件別名來回報問題。收到郵件後，我們的 Marketplace 團隊將會研究適當的行動方案，包括取消發布擴充功能。

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

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 中的某些功能，例如擴充功能。

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

調查 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
    }

我可以在舊版的 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 發行版本。根據您的平台，請務必停用更新以停留在該版本。一個好的建議是以可攜式模式設定安裝。

技術支援

您可以在 Stack Overflow 上提出問題和搜尋答案，並直接在我們的 GitHub 存放庫中輸入問題和功能要求。

如果您想要聯絡專業支援工程師，您可以向 Microsoft 協助支援團隊 開啟支援票證。