VSCode绿色便携版核心是官方ZIP包加同级data文件夹：必须下载Windows ZIP（非.exe安装包），解压至U盘根目录，手动创建全小写data文件夹与Code.exe同级，首次启动自动生成配置；插件需在线安装或通过.vsix离线安装，旧配置仅迁移settings.json等关键文件，避免直接复制整个user-data。
VSCode 在 U 盘上跑绿色便携版，核心就一条：用官方 ZIP 包 + data 文件夹，其他全是干扰项。装错版本（比如点了 VSCodeSetup.exe）或漏建 data，就不是便携版，只是“看起来像”的普通安装。
必须下载 Windows ZIP 版，别碰任何 .exe 安装包
官网 code.visualstudio.com/download 页面往下拉，在 Other Platforms 区域找 Windows ZIP (.zip) —— 这是唯一支持真便携的入口。macOS 选 .tar.gz，Linux 选对应 .tar.gz。所有带 Installer 字样的（User Installer、System Installer）都会写注册表、改系统路径、把配置塞进 %APPDATA%，拔掉 U 盘后一切清零。
- 常见错误现象：
Code.exe双击启动后，插件全空、主题回退、快捷键失效 → 很可能下的是安装版，或 ZIP 解压到了C:\Program Files等受保护路径 - 解压目标必须是 U 盘根目录（如
E:\VSCode\），不能嵌套太深，路径里不能含中文或空格 - U 盘格式建议为
exFAT（兼顾 Windows/macOS 读写），避免 FAT32（单文件超 4GB 会失败）
手动创建 data 文件夹，大小写和位置都不能错
data 是便携模式的开关，VSCode 启动时只认这个名称、这个位置：必须与 Code.exe 同级，全小写，不能叫 Data、DATA 或 vscode-data。它第一次启动时会自动在内部生成 user-data 和 extensions 子目录，你不需要提前往里塞东西。
- 正确结构示例：
E:\VSCode\Code.exe和E:\VSCode\data\（同级） - 错误结构：
E:\VSCode\bin\Code.exe+E:\VSCode\data\（OK），但E:\VSCode\bin\data\（NG，data不在Code.exe同级） - 首次启动后检查：
data\user-data\User\settings.json是否存在；process.env.VSCODE_PORTABLE在开发者工具中应返回data路径
插件不能直接复制 extensions 文件夹
从旧电脑拷 data\extensions 到新 U 盘，大概率导致插件图标灰掉、功能不响应。因为很多插件依赖本地 Node.js 运行时、签名校验或首次激活逻辑，二进制复制不可靠。
- 稳妥做法：在有网环境用 VSCode 内置市场装好插件 → 去
marketplace.visualstudio.com搜索同名插件 → 点页面下方 Download Extension → 得到.vsix文件 → 拷进 U 盘 → 在目标机用扩展面板右上角 ⋯ → Install from VSIX - 若需批量迁移，可导出已安装列表：
code --list-extensions > extensions.txt，再在新环境用脚本循环code --install-extension - 注意：离线安装的
.vsix不包含插件运行时依赖，部分 AI 或 LSP 类插件仍需联网初始化
迁移旧配置要拆开处理，user-data 和 extensions 不能混放
想把现有 VSCode 的设置搬进便携版，不能整个 %APPDATA%\Code 直接覆盖 data。VSCode 会拒绝加载非初始化生成的 user-data 结构，尤其 argv.json 和 globalStorage 容易冲突。
- 安全迁移路径：
→ 把原%APPDATA%\Code\User\settings.json和keybindings.json复制到data\user-data\User\
→ 把原%USERPROFILE%\.vscode\extensions全部内容复制到data\extensions\
→data\user-data\下其余子目录（如GlobalStorage、workspaceStorage）留空，让 VSCode 首次启动时重建 - 关键避坑点：
data\user-data\里不要手动建Machine或Workspaces目录；argv.json必须由 VSCode 自动生成，否则可能触发崩溃 - 迁移后首次启动务必断网，防止 Settings Sync 自动覆盖本地配置
最常被忽略的其实是 data 文件夹权限和 U 盘稳定性。有些公司电脑禁用 USB 存储设备写入，或默认挂载为只读，此时 Code.exe 能启动但插件安装失败、设置无法保存——先在管理员权限 CMD 中执行 attrib -r E:\VSCode\data /s 解除只读属性，再确认 U 盘是否被组策略锁定。
