最可靠方式是手动导出settings.json、keybindings.json、snippets目录及code --list-extensions列表;需从系统级路径获取settings.json,清理绝对路径、平台专属、插件强依赖三类字段后覆盖,Remote场景须同步远程端配置。

VSCode 配置导出不是在某个菜单里点一下就能“一键打包”,它本质是手动复制几个关键文件 + 清理危险字段的过程。直接去「设置 → 导出」会扑空,因为 VSCode 压根没这个功能。
settings.json 文件到底藏在哪?别去安装目录翻
它不在 Visual Studio Code.app 或 Program Files 里,硬找只会浪费时间。真实路径由操作系统决定,且必须从用户配置目录取,否则导出的是空文件或错误配置:
- Windows:
%APPDATA%\Code\User\settings.json(文件资源管理器地址栏粘贴即可直达) - macOS:
$HOME/Library/Application Support/Code/User/settings.json - Linux:
$HOME/.config/Code/User/settings.json
别用「设置 → 打开设置 (JSON)」后全选复制——那只是 UI 渲染快照,会丢掉注释、格式缩进,更漏掉像 "editor.minimap.enabled": false 这种显式禁用项(UI 里根本不显示)。
code --list-extensions 是唯一靠谱的插件导出方式
扩展面板里看到的“Python”“ESLint”只是显示名,真正安装依赖的是 ms-python.python 这类 ID。截图、右键复制 ID、手打都容易错,尤其含 Unicode 或空格时。
- 终端执行
code --list-extensions > extensions.txt,输出纯文本,每行一个 ID,无 BOM、无版本号、不依赖网络 -
code --list-extensions --show-versions会输出带@的格式(如ms-python.python@2024.12.1),但code --install-extension完全不认,直接报错Extension 'xxx@yyy' not found - 禁用的插件不会出现在结果里——这是设计行为,不是 bug;重装时基本不需要记录禁用状态
导出前必须删掉这三类字段,否则静默失效
直接拷贝原 settings.json 到新机器,VSCode 启动时大概率不报错,而是静默跳过整行、回退到默认值,导致 Python 插件报错、files.exclude 不生效、终端乱码等问题。
-
绝对路径类:
"python.defaultInterpreterPath"、"files.exclude"、"search.exclude"中含C:\Users\、/home/、/Users/等 -
平台专属类:
"terminal.integrated.profiles.windows"、"terminal.integrated.fontFamily"(macOS/Linux 下可能阻断加载) -
插件强依赖类:
"prettier.bracketSpacing"、"todo-tree.tree.showScanModeButton"——新机器没装对应插件时,VSCode 直接忽略该行,颜色或行为链可能断裂
建议用 VSCode 自带搜索 Ctrl+F,全局搜 C:、/Users/、/home/、:,整行删或加 // 注释。
Remote-SSH 场景下 settings.json 分两层,漏掉远程端就白配
你连上 SSH: xxx 后,VSCode 实际加载两套配置:本地用户级 + 远程机器上的 ~/.vscode-server/data/Machine/settings.json。常见错误是只改本地设置,结果 files.exclude 对 .env 不生效。
- 确认底部状态栏显示
SSH: xxx,才表示已进入远程上下文 - 必须运行命令面板里的
Preferences: Open Remote Settings (JSON),它编辑的是远程主机上的settings.json,不是本地那个 - 改完保存后,仅刷新或重启 VSCode 不行,必须执行
File > Close Folder → File > Open Folder重载文件夹 - 想让
.env显示但继续隐藏.git和.DS_Store?别删整行"**/.*": true,精细化覆盖:"**/.DS_Store": true、"**/.git/**": true、"**/.*": false
Profile 结构(VSCode 1.86+)、语言包、代码片段这些,都不是简单覆盖就能生效的。最常被忽略的是:改完配置后没彻底退出 VSCode(后台还有 Code Helper 进程),或者用记事本覆盖导致 BOM 头或换行符异常——这些都会让 VSCode 拒绝加载,又不告诉你为什么。


















