尝试以扩展 VS Code 中的代理模式！

便携模式

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 沙箱权限。

Chromium 在 Linux 上具有 多层沙箱模型。如果 Chromium 无法对第 1 层使用命名空间沙箱，它将尝试通过与应用程序二进制文件一起提供的辅助二进制文件 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

如果您的应用程序处于 隔离状态，便携模式将无法工作，这在您刚下载 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 数据。

07/09/2025