必须用ZIP版而非.exe安装包，因为后者会写入注册表并将用户数据默认存至%APPDATA%\Code，导致拔掉U盘后配置丢失；ZIP版是纯绿色二进制，解压即用，便携模式由目录结构（同级data文件夹）自动触发。
直接下载 ZIP 版、解压到 U 盘、在 Code.exe 同级目录新建 data 文件夹，VSCode 就自动进入便携模式——不需要注册表、不改系统路径、不依赖账户登录。
为什么必须用 ZIP 版而不是 .exe 安装包
VSCode 的 Windows VSCodeSetup.exe 会写注册表、把用户数据默认塞进 %APPDATA%\Code，拔掉 U 盘后配置就丢了。ZIP 版（如 VSCode-win32-x64-1.87.0.zip）是纯绿色二进制，解压即用，所有行为由目录结构触发。
- 官网下载页往下拉，在 Other Platforms 区域选
Windows ZIP (.zip)，别点上面的 System Installer - 解压路径必须是纯英文、无空格、无中文，例如
E:\VSCode\，不能是E:\我的开发工具\或E:\VS Code\ - U 盘建议格式化为
exFAT，确保 Windows/macOS 都能读写（NTFS 在 macOS 默认只读）
data 文件夹创建失败的常见表现
双击 Code.exe 后插件安装报错 Failed to install extension，或设置修改后重启消失，大概率是 data 没起作用。
-
data必须和Code.exe在同一级目录，大小写敏感，不能叫Data、DATA或data-folder - 首次启动前
data必须为空；如果从旧电脑迁移配置，只复制extensions，user-data子目录要留空让 VSCode 自己初始化 - Windows 下若提示“无法写入”，右键
data→ 属性 → 安全 → 编辑 → 给当前用户勾上“完全控制”
验证便携模式是否真生效
光看界面没用，得确认实际数据落盘位置。最可靠的方式是打开 VSCode 后执行命令：
- 按
Ctrl+Shift+P→ 输入Developer: Open User Data Folder→ 回车 - 弹出的资源管理器地址栏，路径必须形如
E:\VSCode\data\user-data，而不是C:\Users\xxx\AppData\Roaming\Code - 关掉 VSCode，进
data文件夹检查是否已生成user-data\User\settings.json和extensions\ms-python.python-2024.2.0这类子目录
跨电脑使用时最易忽略的细节
便携版不是“一次制作，到处通用”。不同系统之间不兼容，且部分插件有平台锁。
- Windows 上做的便携版，不能直接扔进 macOS 的
Visual Studio Code.app里运行；macOS 需单独下.tar.gz版并建code-portable-data文件夹 - 某些插件（如 WSL 相关、PowerShell 扩展）在非原生系统上会禁用或报错，不要强求全功能一致
- 拔 U 盘前务必退出 VSCode，否则
data\user-data\argv.json可能损坏，下次启动卡在白屏
