VSCode安装JSONViewer 数据处理必备VSCode格式化JSON

VSCode 里 JSON Viewer 插件根本不能格式化 JSON

先明确一个核心事实：你在 VSCode 里安装的那些名为 “JSON Viewer” 的插件，比如 mechatroner.rainbow-csv 或者旧版 quicktype.quicktype 附带的预览功能，它们干的活儿其实很单一——仅仅是把一长串 JSON 文本渲染成可折叠、可点击展开的树状结构。这就像给一本密密麻麻的书加上目录和书签，方便你浏览，但绝不负责重新排版印刷。

所以，当你按下 Shift+Alt+F 而毫无反应时，别急着怀疑插件没装好。真相是：它压根就没这个能力。格式化 JSON 这项任务，在 VSCode 里向来只由三类角色负责：内置的 vscode.json-language-features 扩展、需要手动配置解析器的 Prettier，或者命令行工具 jq。指望一个 JSON Viewer 插件来“美化缩进”，无异于要求 PDF 阅读器帮你重排 Word 文档的版式。

• JSON Viewer 类插件只做一件事：将类似 {"a":1,"b":[{}]} 这样的原始字符串，转换成可视化的层级视图，它绝不改动字符串内容本身。
• 想实现格式化，必须满足两个前提：文件的语言模式被识别为 JSON，并且有对应的格式化器被启用（默认就是内置的 vscode.json-language-features）。
• 这里有个常见的坑：如果文件右下角显示的是 JSON with Comments，那么 Shift+Alt+F 大概率会直接失效。原因很简单，标准 JSON 规范不允许出现 // 这样的注释。

按 Shift+Alt+F 没反应？先看右下角语言模式和 defaultFormatter

从 VS Code 1.85 版本开始，旧式的 JSON 格式化入口被默认禁用，转而全面依赖 vscode.json-language-features 这个内置扩展（虽然它可能被其他设置覆盖）。快捷键失灵，十有八九是卡在下面这两个环节。

• 第一步，检查语言模式：看一眼编辑器右下角，如果显示的是 Plain Text 或 Ja vaScript，那就手动点开，选择 JSON。
• 第二步，确认默认格式化器：打开设置（Ctrl+,），搜索 defaultFormatter，展开 “JSON” 语言的专属设置项。确保其值被设置为 vscode.json-language-features。
• 需要警惕的是，如果你之前图省事，将全局的 editor.defaultFormatter 设为了 esbenp.prettier-vscode，它处理 JSON 文件时可能会格式化失败，或者自作主张地把双引号改成单引号——Prettier 对 JSON 的支持只是一个子集，并非完全兼容。
• 最后，不妨再检查一下 json.format.enable 这个设置项是否为 true（在 VS Code 设置里直接搜就能找到）。

粘贴过来的 JSON 格式化失败？大概率是脏数据，不是编辑器问题

从浏览器 Network 面板复制的响应体、curl 命令的输出、或者接口文档里直接拷贝的内容，常常夹带“私货”：比如 BOM 头、HTML 错误页面、重定向提示，甚至是 Ja vaScript 风格的注释。这些都不是合法的 JSON，连 JSON.parse() 都会直接报错，VS Code 自然也无从格式化。

• 先验证数据来源：用 curl -v http://api.example.com 查看原始响应，确认响应头包含 Content-Type: application/json，且响应体确实以 { 或 [ 开头。
• 在 VS Code 内尝试：粘贴内容后，按 Ctrl+Shift+P 打开命令面板，输入 Change Language Mode 并选择 JSON，然后再试 Shift+Alt+F。
• 借助外部工具排查：如果仍然报 Unexpected token 这类错误，可以把内容粘贴到 jsonlint.com 这类在线验证网站；或者在命令行用 jq empty 快速检测（例如 echo '{"a":1}' | jq empty，如果没输出错误就表示合法）。
• 清理 BOM 头：最简单的方法是，如果 VS Code 右下角显示编码为 “UTF-8-BOM”，点击它，选择 “Sa ve with Encoding”，然后保存为 “UTF-8” 即可。

想在 JS 文件里格式化一段 JSON 字符串？别依赖插件自动识别

在编写 React 或 Node.js 代码时，我们常会遇到这种情况：一个超长的 JSON 字符串被硬编码在模板字符串里，比如 const data = `{"users":[...]}`，你只想格式化这段 JSON 本身。遗憾的是，许多插件宣传的 “format JSON in string” 功能，在 VS Code 1.85+ 版本上已经不太可靠，容易导致编辑器崩溃或格式化错位。

• 最稳妥的做法：把那串 JSON 单独复制出来，新建一个临时文件，保存为 temp.json，将其语言模式设为 JSON，用 Shift+Alt+F 格式化完毕后，再复制回原处。
• 如果必须在原文件操作：精确选中字符串内容（注意，要剔除外层包裹的反引号或双引号，只保留 {...} 或 [...] 的核心部分），确保选中的内容是合法 JSON，然后尝试使用 Shift+Alt+F —— VS Code 自带的 “Format Selection” 功能，对于纯 JSON 片段的表现相对稳定。
• 避免使用某些插件：尽量不要依赖 Prettier 的 prettier-plugin-jsdoc 或其他带有 JSON 解析逻辑的插件来处理内联字符串，它们对嵌套转义符、换行符的处理规则往往不一致，容易引发意外。

说到底，问题的关键从来不是怎么按那个快捷键，而是你准备格式化的那串字符，究竟是不是一份“干净”的 JSON。验证先行，格式化在后——这个原则，比安装任何插件都来得重要。