参加你附近的 ，了解 VS Code 中的 AI 辅助开发。

便携模式

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 数据。

09/11/2025