VSCode便携版需显式添加--portable参数启动，否则仍写入默认用户目录；扩展安装至data/extensions但部分原生扩展可能失效；自定义--user-data-dir时须同步指定--extensions-dir以确保功能完整。
VSCode 便携版（绿色版）能绕过系统级安装和注册表写入，对启动卡顿、权限不足、杀软拦截、多用户环境冲突等问题有直接缓解效果。但它不是“开箱即用”的完全替代方案，部分功能需手动适配。
便携模式启动必须加 --portable 参数
VSCode 官方便携版不靠文件夹名或路径自动识别模式，必须显式传参，否则仍会读写默认用户数据目录（如 %USERPROFILE%\AppData\Roaming\Code）。
- 正确方式：在终端中运行
Code.exe --portable（Windows）或./code --portable（macOS/Linux） - 双击快捷方式失效？需右键 → “属性” → 在“目标”末尾追加
--portable（注意空格） - 若已误启动过未加参数的实例，先关闭所有 Code 进程，再删掉自动生成的
data子目录（保留user-data和extensions可选）
扩展安装后默认不生效，需确认 extensions 目录位置
便携模式下，VSCode 将扩展安装到 data\extensions（Windows）或 data/extensions（macOS/Linux），而非全局 ~/.vscode/extensions。但部分扩展（尤其含原生二进制模块的）可能因路径硬编码或加载逻辑异常而静默失败。
- 安装扩展后，检查
data\extensions下是否生成对应文件夹（如ms-python.python-2024.2.0） - 若扩展图标不显示或命令不可用，打开命令面板（
Ctrl+Shift+P）运行Developer: Toggle Developer Tools，看 Console 是否报Cannot find module或ENOENT - 遇到 Electron 加载错误（如
Error: Cannot load native module），说明该扩展未适配便携路径，建议换用纯 JS 实现的同类扩展（例如用esbenp.prettier-vscode替代某些带 node-gyp 编译的格式化工具）
设置同步与用户数据隔离需主动配置 --user-data-dir
--portable 默认将用户数据（设置、密钥、工作区状态）存于 data/user-data，但如果你希望完全隔离（比如在 U 盘多机使用且不混用配置），就得额外指定独立目录。
- 例如：启动时用
Code.exe --portable --user-data-dir="D:\vscode-settings\user-data" - 注意：一旦指定
--user-data-dir，--portable的自动目录推导就失效，你必须同时确保--extensions-dir指向同级extensions目录，否则扩展不加载 - 推荐完整命令：
Code.exe --portable --user-data-dir="X:\mycode\user-data" --extensions-dir="X:\mycode\extensions"
便携版最易被忽略的是调试器和终端子进程的继承行为——它们默认仍会读取系统环境变量（如 PATH、NODE_OPTIONS），导致调试失败或终端命令找不到。需要在 data\user-data\settings.json 中显式覆盖 terminal.integrated.env.* 或使用 launch.json 的 env 字段补全。
