便攜模式 (Portable mode)

Visual Studio Code 支援 可攜式模式 (Portable mode)。此模式能讓 VS Code 建立與維護的所有資料皆存放在其安裝目錄附近，以便在不同環境間隨身攜帶。

此模式也提供了一種設定 VS Code 擴充功能安裝路徑的方式，對於禁止將擴充功能安裝至 Windows AppData 資料夾的公司環境相當實用。

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

啟用可攜式模式 (Portable mode)

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 資料夾可以移動到其他 VS Code 安裝目錄。這對於更新您的可攜式版 VS Code 非常有用；您可以將 data 資料夾移至新解壓縮的 VS Code 版本中。

Linux

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

Chromium 在 Linux 上擁有 多層次沙盒模型。如果 Chromium 無法針對第一層使用命名空間沙盒，它會嘗試透過隨應用程式二進位檔一同提供的輔助二進位檔 chrome-sandbox 來使用 setuid 沙盒。

執行下列指令以設定 setuid 輔助程式的正確權限：

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

macOS

在 macOS 上，您需要將資料資料夾放置在應用程式本身的同級目錄下。由於該資料夾將與應用程式並列，您必須使用特定的名稱，以便 VS Code 能夠找到它。預設的資料夾名稱為 code-portable-data。

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

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

xattr -dr com.apple.quarantine Visual\ Studio\ Code.app

更新可攜式版 VS Code

在 Windows 與 Linux 上，您可以透過將 data 資料夾複製到較新版本的 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 資料。