json树状视图不显示，需先确认文件为合法json且被识别为json语言模式；右下角状态栏应显示json而非plain text或jsonc，否则插件不激活；语法错误（如注释、尾随逗号）会导致解析失败，插件静默失效。
JSON树状视图不显示？检查文件是否真为合法JSON
VS Code 的 JSON 插件（vscode-json）只对语法正确的 .json 文件激活树状视图。常见错误是文件看似 JSON，实则含注释、尾随逗号或未加引号的键名——这些都会导致插件静默失效。
- 打开文件后，右下角状态栏应显示
JSON（而非Plain Text或JSONC），否则插件不会加载树状面板 - 按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，查看 Console 是否报错Unexpected token—— 这说明解析失败 -
package.json和tsconfig.json等标准配置文件默认支持注释（即JSONC格式），但vscode-json插件默认不处理JSONC；如需支持，须手动在设置中启用JSON-zain.json.allowComments
右键重命名后键没更新？确认你用的是插件原生操作
插件的 右键 → Rename Key 功能只作用于树状视图中的节点，且仅修改当前层级的键名，不会递归替换所有引用——它不是全局搜索替换，而是结构化编辑。
- 必须在左侧 JSON 树状面板中右键点击键名（不是编辑器里代码行），才能触发智能重命名
- 若键值是对象或数组，重命名后其子结构会完整保留，但键名变更不会自动同步到其他文件（如 TypeScript 接口定义或前端代码里的字符串字面量）
- 重命名时若输入非法字符（如空格、点号、斜杠），插件会直接拒绝并弹出提示，而非静默失败
树状视图卡顿或刷新延迟？调整 autorefresh 和深度限制
大型 JSON（如 API 响应快照、导出的数据库记录）可能含数百个嵌套层级和数千字段，树状视图默认全量解析会导致明显卡顿。
- 在 VS Code 设置中搜索
JSON-zain.json.autorefresh，设为false可禁用实时刷新，改为手动点击树状面板顶部的↻按钮更新 - 插件内部对嵌套深度做了硬性截断（默认 10 层），超深结构会被折叠显示为
... (truncated)；如需展开，需修改插件源码中的MAX_DEPTH常量（位于src/json/jsonOutline.ts） - 若文件大于 2MB，建议先用命令行工具预处理：例如
npx json -f config.json | head -n 1000 > preview.json，再用插件打开精简版
settings.json 中的 JSON 配置被覆盖？理解用户级与工作区级优先级
settings.json 是 VS Code 自身的配置文件，但它本身也是 JSON——而它的生效逻辑受分层覆盖规则约束，常被误认为“改了就立刻生效”。
- 工作区级
.vscode/settings.json会覆盖用户级~/.vscode/settings.json，但无法覆盖远程开发容器或 GitHub Codespaces 中的托管设置 - 某些设置（如
editor.formatOnSave）在插件启用后才真正生效；若插件未启动，即使配置正确，格式化也不会触发 - 修改
settings.json后，部分设置需重启 VS Code 才能生效（尤其是影响语言服务的项，如json.schemas）
