VSCode便携模式需通过创建同级小写data文件夹或使用--user-data-dir参数强制指定本地路径实现，否则仍写入系统目录；验证方式是执行Developer: Open User Data Folder，路径必须指向本地data文件夹才算生效。
VSCode 没有官方“免安装便携版”，但能通过目录结构或启动参数实现真正便携——关键不是下载哪个包，而是让它**只读写你指定的本地文件夹**；否则哪怕你复制整个安装目录，它仍会偷偷往 %APPDATA%\Code（Windows）或 ~/Library/Application Support/Code（macOS）写数据。
怎么确认 VSCode 正在跑便携模式
别靠猜测，必须验证。打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），执行：Developer: Open User Data Folder。如果弹出的路径是类似 D:\VSCode-Portable\data 或 /Users/me/VSCode-Portable/data，才算成功；若指向系统路径，说明根本没进便携模式。
- 常见误判点：
data文件夹拼成Data、DATA或data/（带斜杠）——必须全小写、无扩展名、同级、空 - 解压路径含中文、空格、括号（如
C:\我的工具\VSCode）会导致静默失败，退回到默认路径 - macOS 用 .dmg 安装版再建
data文件夹无效，必须走命令行参数
Windows 下 ZIP 版 + 同级 data 文件夹（最简方式）
这是最省事的方案，无需脚本、无需参数，但对路径和命名极其敏感：
- 从
code.visualstudio.com/download下载 Windows ZIP（不是 .exe 安装包） - 解压到纯英文、无空格路径，例如：
D:\VSCode-Portable（不能放桌面、不能放Program Files） - 在该根目录下新建空文件夹，严格命名为：
data（与Code.exe同级） - 双击
Code.exe启动，等几秒，检查data目录是否自动生成user-data、extensions子目录
首次启动后，状态栏右下角不会显示“Portable Mode”字样，但 process.env.VSCODE_PORTABLE 在开发者工具中会返回 data 路径，可作二次验证。
macOS 必须用 --user-data-dir 参数启动
macOS 的 .app 包不支持自动识别同级 data 文件夹，这是官方限制，不是你操作错了。必须显式传参：
- 把
Visual Studio Code.app放进一个独立文件夹，比如：~/Documents/VSCode-Portable - 在该文件夹内运行：
mkdir data - 终端执行完整命令（注意引号和路径）：
open -n -b "com.microsoft.VSCode" --args --user-data-dir="$HOME/Documents/VSCode-Portable/data" --extensions-dir="$HOME/Documents/VSCode-Portable/data/extensions" - 为避免每次敲命令，可创建
start.sh脚本并赋予执行权限：chmod +x start.sh
漏掉 --extensions-dir 是常见坑：扩展会装进系统默认位置，导致插件不加载或报 Failed to load extension。
哪些东西真便携，哪些其实不保险
data 目录里能可靠带走的：settings.json、keybindings.json、snippets/、已安装扩展（完整解压包）、工作区缓存（workspaceStorage）、Git 历史索引（global-storage）。
- 某些插件（如旧版
ms-python.python）会硬编码缓存路径到%TEMP%或注册表，这类功能在便携模式下会失效或降级 - 系统级设置（如 GPU 加速开关、代理配置）仍由主程序读取，不存于
data中，但日常开发极少需要改这些 - 扩展市场访问本身不受限，但若加了
--disable-extension-gallery参数，则无法在线安装新插件
便携的核心不是“所有路径都绝对本地化”，而是“用户可控制的配置和行为完全隔离”。只要 Developer: Open User Data Folder 指向你的 data，就达到了实际可用的便携目标。
