notepad++ v7.9+ 已内置 json viewer 插件但需手动启用:先设语言为 json,再尝试插件菜单操作;v8.0+ 需离线安装匹配架构的 dll 至 plugins\nppjsonviewer\ 目录;format json 报错说明 json 本身不合法;v8.6+ 已完全移除传统插件支持。

Notepad++ v7.9+ 用户:别装,先确认是否已内置但未启用
Notepad++ v7.9 及以上版本(含当前最新版 v8.6)已将 JSON Viewer 插件内置,但默认不激活。你看到菜单里插件项是灰色的,不是没装,而是“语言模式不对”或“插件被禁用”。
操作路径:语言 → J → JSON(必须选这个,不是 JavaScript、JScript 或 Text),然后立刻去 插件 → JSON Viewer → Format JSON 尝试点击——如果能点,说明插件已就位;如果仍灰,再检查是否误关了插件加载开关。
关键点:
- 内置插件不会出现在插件管理器列表里,搜不到是正常的
- 右下角状态栏会显示“JSON”字样,这是语言模式生效的唯一可靠提示
- 若切换语言后仍无效,重启 Notepad++ 前先关闭所有后台进程(任务管理器里杀掉全部
notepad++.exe)
Notepad++ v8.0+ 手动安装失败:90% 是 DLL 位数或路径写错
v8.0 开始,Notepad++ 彻底弃用旧式插件加载机制,Plugins Admin 不再提供 JSON Viewer,必须离线部署,且对路径和文件名极其敏感。
正确做法分三步:
- 打开
帮助 → 关于 Notepad++,看右下角明确写着x64还是x86(注意:不是系统架构,是 Notepad++ 自身运行架构) - 去 GitHub 下载匹配版本:
NPPJSONViewer-x64.zip(x64)或NPPJSONViewer-x86.zip(x86),推荐 kapilratnani/JSON-Viewer 仓库最新 release - 解压后,把
NPPJSONViewer.dll放进plugins\NPPJSONViewer\NPPJSONViewer.dll(注意:子目录名必须是NPPJSONViewer,大小写不能错,不能多空格、不能加下划线)
常见错误:
- 把 DLL 直接丢进
plugins\根目录 → 加载失败,无提示 - 子目录名写成
nppjsonviewer或NPP-JSON-Viewer→ 静默忽略 - 用管理员权限运行 Notepad++ 安装插件,但普通用户权限启动 → 插件不加载(Win10/11 UAC 隔离导致)
Format JSON 报 “Invalid JSON”:不是插件问题,是数据本身不合法
JSON Viewer → Format JSON 闪退、变空、或弹出 Invalid JSON 提示,基本可断定原始文本含语法错误。这个插件底层调用系统级 JSON 解析器,不补全、不容错。
验证前必做三件事:
- 用
https://jsonlint.com粘贴原始内容,确认无报错(尤其注意:末尾逗号、单引号、//注释、BOM 头) - 在 Notepad++ 中全选内容(
Ctrl+A),避免折叠区域干扰解析 - 确认当前文档编码为
UTF-8 无 BOM(菜单编码 → UTF-8 无 BOM)
典型陷阱:
- 从浏览器 DevTools 复制的响应体可能带
Response Headers或Preview截断内容 - 日志中提取的 JSON 片段常混有前后文(如
data: {...}),需手动删净 - 部分 API 返回的是
application/json;charset=utf-8,但实际内容含 HTML 错误页(如 500 页面)
插件菜单完全不出现:检查 Notepad++ 启动时是否加载失败
菜单栏顶部连 Plugins 下拉项里都没有 JSON Viewer,说明 Notepad++ 启动阶段就跳过了该插件。这不是配置问题,是加载链断裂。
排查顺序:
- 打开
%AppData%\Notepad++\plugins\config\,删掉pluginmanager_gpup.xml(插件管理器缓存损坏常见) - 检查 Notepad++ 安装路径是否含中文、空格或括号(如
C:\Program Files (x86)\Notepad++)→ 部分插件初始化失败会导致整个插件菜单异常 - 临时把 Notepad++ 移到纯英文路径(如
C:\np\),重装插件再试 - Windows 防火墙/杀软拦截了
notepad++.exe的 socket 初始化(尤其企业环境),可临时禁用测试
最易被忽略的一点:v8.6+ 已彻底移除对传统 DLL 插件的支持,如果你用的是这个版本,NPPJSONViewer.dll 无论怎么放都不会生效——必须降级到 v8.5.x 或改用其他方案(如内置的 Language → JSON → Pretty print,但功能极简)。











