VSCode 用户级 settings.json 文件路径因系统而异:Windows 在 %APPDATA%\Code\User\settings.json,macOS 在 $HOME/Library/Application Support/Code/User/settings.json,Linux 在 $HOME/.config/Code/User/settings.json。

VSCode 的 settings.json 文件在哪
VSCode 的用户级配置都存在 settings.json 里,不是 UI 界面点点就完事的——那是缓存视图。真实生效、可版本控制、能备份迁移的,只有这个文件。
路径取决于操作系统:
- Windows:
%APPDATA%\Code\User\settings.json - macOS:
$HOME/Library/Application Support/Code/User/settings.json - Linux:
$HOME/.config/Code/User/settings.json
别直接改 VSCode 设置界面后就以为“已保存”——它确实会写入该文件,但手动编辑更可控,也方便 Git 管理。
导出时要不要连 extensions 一起备份
只导出 settings.json 不够。很多设置(比如 Prettier 默认格式化器、ESLint 自动修复)依赖扩展存在;没装对应 extension,配置就是摆设。
导出扩展列表用命令行最稳:
code --list-extensions > extensions.txt
如果想一键重装(比如换电脑):
- 逐个安装:
cat extensions.txt | xargs -I {} code --install-extension {} - Windows PowerShell 替代:
Get-Content extensions.txt | ForEach-Object { code --install-extension $_ }
注意:code 命令需已加入系统 PATH;没装 CLI 工具?在 VSCode 里按 Ctrl+Shift+P → 输入 Shell Command: Install 'code' command in PATH 回车即可。
Vuex是一个专门为Vue.js应用设计的状态管理模型 + 库。它为应用内的所有组件提供集中式存储服务,其中的规则确保状态只能按预期方式变更。它可以与 Vue 官方开发工具扩展(devtools extension) 集成,提供高级特征,比如 零配置时空旅行般(基于时间轴)调试,以及状态快照 导出/导入。本文给大家带来Vuex参考手册,需要的朋友们可以过来看看!
导入配置时 settings.json 被覆盖或合并失败
直接替换 settings.json 是最简单方式,但有风险:你本地可能有未同步的临时修改(比如某项目临时关了 "editor.formatOnSave"),一覆盖就丢。
更安全的做法是「合并」而非「覆盖」:
- 用 VSCode 打开原
settings.json和备份文件,人工比对差异(推荐用diff或 VSCode 内置比较功能) - 重点关注字段如:
"files.autoSave"、"workbench.colorTheme"、"[javascript]"这类语言专属块——它们容易因版本升级格式微变,直接粘贴可能报 JSON 解析错误 - 导入后务必重启 VSCode,部分设置(如主题、快捷键)不重启不生效
常见错误提示 Unexpected token } in JSON at position XXX,八成是复制时多了一个逗号,或少了引号——JSON 严格,别手抖。
分享配置给团队时要注意什么
公开分享 settings.json 前必须清理敏感项。以下字段极可能泄露环境或隐私:
-
"git.postCommitCommand"可能含自定义 hook 路径 -
"terminal.integrated.env.*"可能带 API key 或本地路径 -
"python.defaultInterpreterPath"是绝对路径,别人机器上根本不存在 - 任何以
token、key、secret为名的字段,一律删掉
团队共用配置建议拆成两层:
- 基础层(共享):
settings.json放通用规则(缩进、字体、格式化开关) - 个人层(不共享):用
settings.json的"[javascript]"块或workspaceSettings.json做项目/人差异化
真正难的不是备份,是判断哪些配置值得分享、哪些只是你个人习惯的残影。









