VSCode便携模式需手动配置--user-data-dir和--extensions-dir参数，使设置、插件等数据存于本地目录；否则默认写入系统路径，无法真正便携。
VSCode 官方没有“便携版安装包”，所谓便携版本质是让 Code.exe（Windows）或 Electron（macOS）把所有用户数据强制写进你指定的本地文件夹，而不是默认的系统路径。只要目录结构或启动参数到位，它就自动进入便携模式；否则哪怕你复制整个 ZIP 解压目录，它照样往 %APPDATA%\Code 写设置、装扩展——根本不算便携。
怎么确认 VSCode 正在用便携模式？
别信“解压即用”这种说法，必须验证。最直接的办法是打开命令面板（Ctrl+Shift+P），输入并执行：Developer: Open User Data Folder。如果弹出的资源管理器地址是类似 D:\vscode-portable\data 这样的本地路径，说明生效；若指向 %APPDATA%\Code 或 ~/Library/Application Support/Code，那它根本没走便携逻辑。
-
process.env.VSCODE_PORTABLE在开发者工具控制台里输出的是data路径，也表示成功 - 状态栏右下角不会出现“Settings Sync”图标（除非你手动登录）
- 关闭 VSCode 后检查
data目录下是否生成了user-data、extensions、global-storage等子目录
Windows 下最稳的便携启动方式
推荐用官方 ZIP 版 + 显式参数启动，兼容性最好，不依赖目录命名约定，也不怕误点开始菜单里的旧快捷方式。
- 从
code.visualstudio.com/download下载 “Windows ZIP (.zip)” 版本，解压到非系统盘路径（如D:\vscode-portable），路径中不能含中文、空格或 OneDrive 同步目录 - 在该目录下新建空文件夹：
data和extensions（注意全小写） - 创建批处理文件
start.bat，内容为：Code.exe --user-data-dir="./data" --extensions-dir="./extensions"
- 双击运行
start.bat—— 这个动作确保调用的是当前目录下的Code.exe，而非系统 PATH 里的全局版本
⚠️ 常见失败点：--extensions-dir 必须显式传，否则新版 VSCode 会忽略 ./data/extensions，导致插件装不上或卸载后残留。
macOS/Linux 怎么避免 Electron 路径踩坑
macOS 的 Visual Studio Code.app 是 bundle 结构，不能像 Windows 那样直接双击 Code.exe。必须通过 Electron 二进制启动，并传绝对路径。
- 把
Visual Studio Code.app拖进一个独立文件夹（如~/vscode-portable），不要放在/Applications里 - 在该文件夹下新建
data目录 - 终端执行（注意替换为你的真实路径）：
open -n -b "com.microsoft.VSCode" --args --user-data-dir="/Users/you/vscode-portable/data" --extensions-dir="/Users/you/vscode-portable/data/extensions"
- 为省事可存成
start.sh并chmod +x，但不能双击运行——macOS 不认 shell 脚本双击启动
⚠️ 如果用 ../../../MacOS/Electron 相对路径启动，容易因工作目录变化失效；--user-data-dir 必须是绝对路径，否则 VSCode 会静默 fallback 到默认位置。
为什么 data 文件夹名必须小写、且不能放错层级？
VSCode 启动时会扫描自身可执行文件的**同级目录**，找名为 data 的文件夹（大小写敏感）。一旦拼错成 Data、DATA 或放在 bin/code.exe 的上两级，它就完全无视。
- 正确结构示例：
D:\vscode-portable\Code.exe和D:\vscode-portable\data是平级 - 错误结构：
D:\vscode-portable\bin\Code.exe+D:\vscode-portable\data✅ 可行；但D:\vscode-portable\bin\data❌ 不识别 - Linux/macOS 同理：
code可执行文件和data必须在同一个父目录下
这个检测逻辑是硬编码在启动流程里的，不读配置、不看环境变量，错一点就回归默认行为——这也是很多人试了几次都说“便携模式没用”的根本原因。
