🚀 在 ！

可攜式模式

Visual Studio Code 支援可攜式模式。此模式讓 VS Code 建立和維護的所有資料都存在於其附近，因此可以在不同環境之間移動。

此模式也提供了一種設定 VS Code 擴充功能安裝資料夾位置的方式，這對於阻止擴充功能安裝在 Windows AppData 資料夾中的企業環境非常有用。

Windows 的 ZIP 下載、Linux 的 TAR.GZ 下載以及 macOS 的常規應用程式下載都支援可攜式模式。請參閱下載頁面，找到適用於您平台的正確 .zip / .tar.gz 檔案。

重要

請勿嘗試在從 Windows 使用者或系統安裝程式安裝的版本上設定可攜式模式。可攜式模式僅在 Windows ZIP (.zip) 封存檔中受支援。另請注意，Windows ZIP 封存檔不支援自動更新。

啟用可攜式模式

Windows、Linux

解壓縮 VS Code 下載檔案後，在 VS Code 的資料夾中建立一個 data 資料夾

|- VSCode-win32-x64-1.84.2
|   |- Code.exe (or code executable)
|   |- data
|   |- bin
|   |  |- code
|   |  |- ...
|   |- ...

從此以後，data 資料夾將用於包含所有 VS Code 資料，包括工作階段狀態、喜好設定、擴充功能等等。

注意事項

data 資料夾將覆寫 --user-data-dir 和 --extensions-dir 命令行 選項。

data 資料夾可以移動到其他 VS Code 安裝。這對於更新您的可攜式 VS Code 版本非常有用，在這種情況下，您可以將 data 資料夾移動到較新解壓縮的 VS Code 版本。

Linux

在 Linux 上，除了建立 data 資料夾之外，您還需要設定正確的 Electron sandbox 權限。

Chromium 在 Linux 上具有多層沙箱模型。如果 Chromium 無法將命名空間沙箱用於第 1 層，它將嘗試透過隨應用程式二進位檔一起提供的 helper 二進位檔 setuid 沙箱 使用 setuid 沙箱。

執行以下命令以設定 setuid helper 的正確權限

sudo chown root <path-to-vscode>/chrome-sandbox
sudo chmod 4755 <path-to-vscode>/chrome-sandbox

macOS

在 macOS 上，您需要將 data 資料夾放置為應用程式本身的同層級。由於資料夾將與應用程式並排放置，因此您需要明確命名它，以便 VS Code 可以找到它。預設資料夾名稱為 code-portable-data

|- Visual Studio Code.app
|- code-portable-data

如果您的應用程式處於隔離狀態（如果您剛下載 VS Code，預設會發生這種情況），可攜式模式將無法運作。如果可攜式模式似乎無法運作，請確保您移除隔離屬性

xattr -dr com.apple.quarantine Visual\ Studio\ Code.app
注意事項

在 Insiders 版本上，資料夾應命名為 code-insiders-portable-data。

更新可攜式 VS Code

在 Windows 和 Linux 上，您可以透過將 data 資料夾複製到較新版本的 VS Code 來更新 VS Code。

在 macOS 上，自動更新應該像往常一樣運作，無需額外操作。

移轉至可攜式模式

您也可以將現有的安裝移轉至可攜式模式。

Windows、Linux

  1. 下載適用於您平台的 VS Code（或 VS Code Insiders）ZIP 發行版本。
  2. 如上所述建立 data 資料夾。
  3. 將使用者資料目錄 Code 複製到 data 並重新命名為 user-data
    • Windows %APPDATA%\Code
    • Linux $HOME/.config/Code
  4. 將擴充功能目錄複製到 data
    • Windows %USERPROFILE%\.vscode\extensions
    • Linux ~/.vscode/extensions

例如，以下是 Windows 上所需的結果

|- VSCode-win32-x64-1.84.2
|   |- Code.exe (or code executable)
|   |- data
|   |   |- user-data
|   |   |   |- ...
|   |   |- extensions
|   |   |   |- ...
|   |- ...

macOS

  1. 下載適用於 macOS 的 VS Code（或 VS Code Insiders）。
  2. 如上所述建立 code-portable-data 資料夾。
  3. 將使用者資料目錄 Code 複製到 code-portable-data 並重新命名為 user-data
    • $HOME/Library/Application Support/Code
  4. 將擴充功能目錄複製到 code-portable-data
    • ~/.vscode/extensions

TMP 目錄

預設情況下，即使在可攜式模式下，預設 TMP 目錄仍然是系統目錄，因為那裡沒有保留任何狀態。如果您也希望將 TMP 目錄放在可攜式目錄中，您可以在 data 資料夾內建立一個空的 tmp 目錄。只要 tmp 目錄存在，它就會用於 TMP 資料。

04/03/2025