VSCode的“可移植模式”是什么,如何开启?

18次阅读

需启用vscode便携模式实现配置全打包:仅限ZIP版,解压至纯英文路径;在根目录新建data文件夹;启动后验证User Data Folder是否指向该data目录;异常时可用–user-data-dir=./data参数强制指定。

VSCode的“可移植模式”是什么,如何开启?

如果您希望将 visual studio Code 的全部配置、扩展和用户数据打包进一个独立目录,以便在不同电脑间即插即用,则需要启用其“可移植模式”。该模式使 VSCode 放弃使用系统级用户目录存储设置,转而将所有状态写入本地指定文件夹。以下是开启此模式的具体操作步骤:

本文运行环境:macBook Pro M2,macOS Sequoia

一、准备 ZIP 版本的 VSCode

便携模式仅支持从官网下载的 ZIP 压缩包版本,不支持安装程序(.exe 或 .pkg),因为安装版会将数据写入系统路径,无法实现真正可移植。

1、访问 code.visualstudio.com 官网,选择对应平台的 .zip 格式下载项macos 用户请选择 arm64 或 universal 版本)。

2、解压下载的 ZIP 文件至一个纯英文、无空格、无中文字符的路径,例如:/Volumes/usb/VSCode-Portable

二、创建 data 文件夹

VSCode 启动时会主动检测同级目录下是否存在名为 data 的空文件夹;若存在,即自动激活便携模式,并将所有用户数据(包括 settings.json、extensions、cache、snippets 等)严格限定在该文件夹内。

1、在解压后的 VSCode 根目录(即包含 Code.app 或 Code.exe 的目录)中,新建一个名为 data 的空文件夹。

2、确认该文件夹与 Code.app(macOS)或 Code.exe(windows)处于同一层级,路径结构示例如下:/Volumes/USB/VSCode-Portable/data

三、首次启动并验证模式

启动 VSCode 后,需确认其是否已正确识别为便携模式,避免误用系统默认配置路径导致数据分散。

1、双击运行 Code.app(macOS)或 Code.exe(Windows)。

2、打开命令面板(Cmd+Shift+P),输入 Developer: Show Running Extensions 并执行,观察输出中的 User Data Folder 路径是否指向您创建的 data 目录内部。

3、若路径形如 /Volumes/USB/VSCode-Portable/data/user-data,则表示便携模式已成功启用。

四、通过命令行参数强制启用

当因目录结构异常或缓存残留导致自动检测失败时,可绕过检测机制,直接以命令行参数强制指定数据目录,确保可移植性不受干扰。

1、打开终端,进入 VSCode 根目录,执行:./Code.app/Contents/MacOS/electron –user-data-dir=./data(macOS)。

2、Windows 用户可在 PowerShell 中执行:.Code.exe –user-data-dir=./data

3、linux 用户执行:./code –user-data-dir=./data

text=ZqhQzanResources