mklink /D 是最稳妥的迁移方式，因其直接作用于文件系统层级，对所有启动方式（如右键菜单、任务栏图标）透明生效，不依赖 VS Code 版本更新或环境变量，只要 NTFS 分区支持即稳定可靠。

为什么 mklink /D 是最稳妥的迁移方式

VS Code 没有提供官方配置项来修改插件或用户数据的默认路径，--extensions-dir 和 --user-data-dir 启动参数在某些场景下会失效（比如通过右键菜单“Open with Code”、任务栏固定图标、或系统级集成调用时），而符号链接直接作用于文件系统层级，对所有访问方式都透明生效。它不依赖 VS Code 版本更新逻辑，也不受环境变量干扰，只要 NTFS 分区支持，就稳定可靠。

迁移前必须确认的三件事

避免执行后插件全丢或 VS Code 启动失败：

• 关闭所有 Code.exe、Code Helper.exe 进程（任务管理器 → 详细信息 → 结束全部）
• 确认目标盘是 NTFS 格式（FAT32/exFAT 不支持 mklink；可用 fsutil fsinfo ntfsinfo F: 验证）
• 确保原目录 %USERPROFILE%\.vscode\extensions 和 %APPDATA%\Code 已完全移出或清空（残留会导致 mklink 报错 “当文件已存在时，无法创建该文件”）

分步执行：先插件，再用户数据

两个关键目录建议分开处理，降低风险：

① 迁移插件目录：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

mklink /D "%USERPROFILE%\.vscode\extensions" "F:\VSCode\extensions"

② 迁移用户数据（含 settings.json、keybindings.json、snippets 等）：

mklink /D "%APPDATA%\Code" "F:\VSCode\Data"

注意：/D 表示创建目录符号链接；路径中含空格必须用英文双引号包裹；管理员权限缺一不可。

容易被忽略的兼容性细节

符号链接本身无版本限制，但迁移后首次启动 VS Code 时可能触发以下行为：

• 部分插件（如 Remote - SSH、Docker）会重写本地状态路径，需检查其输出面板是否报 ENOENT 或连接失败
• 如果之前用过 --extensions-dir 参数启动过，VS Code 可能缓存了旧路径，建议删除 %USERPROFILE%\.vscode\argv.json 清除启动参数记忆
• 企业内网或策略锁定环境，组策略可能禁用符号链接创建（错误提示为 “拒绝访问”），此时只能改用启动参数方式

真正麻烦的不是命令敲错，而是以为迁完了就万事大吉——实际插件没加载、设置没同步、甚至扩展市场打不开，往往是因为其中一个链接没生效，或者某个进程还在锁着原目录。