直接修改 settings.json 是唯一能绕过 GUI 限制、稳定接管格式化链路、精准控制语言行为的方式,需确保编辑的是正确层级的文件,配置键值对必须严格遵循语法与优先级规则。

直接改 settings.json 是唯一能绕过 GUI 限制、稳定接管格式化链路、精准控制语言行为的方式。图形界面点一百次也不如一行 "editor.formatOnSave": true 管用,但写错位置或格式就会让整个配置失效。
怎么确认自己在编辑正确的 settings.json
左下角状态栏必须显示「用户」或「工作区」——如果打开项目却看到「用户」,那 eslintrc 路径、prettier.requireConfig 这类项目级设置根本不会生效。快捷键 Cmd + ,(macOS)或 Ctrl + ,(Windows/Linux)后点右上角 {} 图标,VSCode 才会自动选对层级。手动拼路径容易出错,尤其在 WSL 或双系统里,~/Library/Application Support/Code/User/settings.json 这种写法稍有空格或大小写偏差就白改。
格式化不触发?先查这三个键的嵌套关系
editor.formatOnSave 只是开关,真正决定“谁来格式化”和“对谁生效”的是另外两个机制:
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
-
editor.defaultFormatter必须设成已安装扩展的 ID,比如"esbenp.prettier-vscode";填错 ID 或扩展没装,保存时完全静音 - 语言特设块像
"[javascript]"是对象,不是数组,括号里不能加引号,也不能写成"javascript" -
prettier.requireConfig设为true后,没有.prettierrc文件时连formatOnSave都会被跳过,不是报错而是沉默失效
文件一多就卡?watcher 和 exclude 不是可选项
大型项目里 files.watcherExclude 和 search.exclude 不配等于主动拖慢编辑器。VSCode 默认监听整个工作区,node_modules 里几万个文件变动都会触发重解析:
-
"files.watcherExclude": { "**/node_modules/**": true, "**/dist/**": true }—— 斜杠统一用/,Windows 下也别写\ -
"search.exclude": { "**/build/**": true, "**/*.log": true }—— 这个影响 Ctrl+Shift+F 全局搜索速度,不是视觉隐藏 -
"files.exclude"是资源管理器里“看不见”,而search.exclude是“搜不到”,两者作用域不同,别混用
中文乱码、终端启动失败、缩进错乱——这些都不是玄学
它们全由底层键值对控制,且优先级敏感:
-
"files.encoding": "utf8"必须小写,写成"UTF-8"或"utf-8"都无效 -
"terminal.integrated.defaultProfile.osx"在 macOS 上必须对应 Shell 名字,"zsh"可以,"/bin/zsh"就不行 -
"editor.detectIndentation"设为false才能让editor.tabSize和editor.insertSpaces真正生效;默认true时 VSCode 会反复读取文件首行缩进并覆盖你的设置
JSON 语法错误最常发生在尾随逗号、单引号、或者注释写在对象外层——VSCode 不报错,只是静默忽略后续所有配置。每次改完记得看右下角有没有黄色感叹号提示。

















