VSCode 便携模式通过在安装目录下创建 data 文件夹实现，所有设置、扩展、缓存等数据均存于该文件夹内，不写入系统路径，支持 U 盘携带与多机切换。
VSCode 的便携模式（Portable Mode）能让整个编辑器连同设置、扩展、缓存等全部数据保存在本地文件夹中，不写入系统 注册表 或用户目录，适合 U 盘携带、多机切换或免安装使用。
什么是便携模式
便携模式不是单独下载的版本，而是通过在 VSCode 安装目录中创建特定文件夹结构来启用的一种运行方式。它让 VSCode 把 用户数据 （如 settings.json、extensions、globalStorage）和 工作区数据（如窗口布局、最近打开的文件）全部存放在你指定的本地路径下，而非默认的 %APPDATA%Code（Windows）、~/Library/Application Support/Code（macOS）或 ~/.config/Code（Linux）。
如何创建便携模式
只需在 VSCode 的根目录（即包含 Code.exe 或 Code 可执行文件的文件夹）下新建一个名为 data 的空文件夹即可。VSCode 启动时会自动识别并进入便携模式。
- Windows：解压或复制 VSCode 官方 ZIP 版到任意位置（如
D:vscode-portable），在其下新建data文件夹 - macOS：将 .zip 解压后的
Visual Studio Code.app复制到目标位置，右键「显示包内容」→ 进入Contents/MacOS/，在此目录旁新建data文件夹（注意不是放在 app 包内部） - Linux：解压
.tar.gz后，在解压出的code目录同级新建data文件夹
✅ 验证是否生效：启动 VSCode 后，打开命令面板（Ctrl+Shift+P），输入并执行 Developer: Toggle Developer Tools，在控制台中输入 process.env.VSCODE_PORTABLE，返回路径即表示已启用。
便携模式下的数据存放规则
启用后，所有用户级数据都会落到 data 文件夹内，结构如下：
-
data/user-data/→ 替代原user-data目录，含settings.json、keybindings.json、snippets/等 -
data/extensions/→ 所有已安装扩展（.vsix 解压后文件） -
data/global-storage/→ 扩展的全局状态（如 Git History、Todo Tree 的缓存） -
data/workspaces/→ 工作区元数据（如窗口大小、折叠状态）
⚠️ 注意：扩展安装仍需联网下载，但安装后所有文件都保留在 data/extensions/ 中；卸载扩展也会从该目录清理，不会残留系统其他位置。
实用建议与注意事项
- 推荐使用官方 ZIP/TAR.GZ 版本启动便携模式，避免用 Windows Installer（.exe）或 macOS pkg 安装版，因其默认写注册表或系统路径，不易干净隔离
- 可为不同用途建多个便携实例（如
vscode-web-dev和vscode-python-learn），各自独立配置与扩展，互不干扰 - 备份或迁移只需复制整个文件夹（含
data），无需导出导入设置 - 若想临时退出便携模式，重命名或移走
data文件夹，重启即可恢复默认行为
基本上就这些。便携模式不复杂但容易忽略，对开发者、教学演示或临时环境特别友好。
