Navicat Premium v15+ 是前提，否则 JSON 树形编辑器不可用；仅 Premium 版本 ≥v15 支持双击弹出树形 JSON 视图，v12–v14 或 Standard/Essentials 版本仅显示纯文本，且需数据库原生支持 JSON（MySQL≥5.7.8、PostgreSQL≥9.4），跨平台时还需注意 BOM、换行符、大小写匹配及字段类型手动修改等限制。
Navicat Premium v15+ 是前提，否则 JSON 树形编辑器不可用
跨平台开发中常需在 windows/macos/linux 间切换数据库操作环境，但 navicat 的 json 编辑能力严重依赖版本与许可类型：只有 navicat premium（非 standard/essentials）且版本 ≥ v15 才提供双击单元格弹出的树形 json 视图。v12–v14 或低版本 premium 即使连接 mysql 8.0，也仅显示为纯文本，无法折叠、高亮或点击展开节点。
容易踩的坑：
- 在 macOS 上装了 Navicat Premium v16，却连的是本地 MySQL 5.6 ——
SELECT VERSION()返回5.6.43，此时下拉菜单里根本不会出现JSON类型选项，更别提编辑器 - Windows 上用 Navicat Premium v15 连接远程 PostgreSQL 9.3，同样不支持
JSON字段，因为 PostgreSQL 原生 JSON 支持始于9.4 - Linux 下通过 Wine 运行 Navicat（非官方支持），JSON 视图常因字体渲染或 Qt 兼容问题卡死，建议改用原生 Linux 版本
字段已设为 JSON，但双击没反应？试试这几种触发方式
不是所有“双击”都能激活 JSON 编辑器。不同平台/版本行为不一致，常见失效场景和绕过方法如下：
- macOS：双击无响应 → 改为「右键 → 编辑值」，或先单击选中单元格，再按
空格键 - Windows：鼠标悬停有提示但点击无效 → 检查该字段是否被设为
NOT NULL且当前值为NULL；Navicat v15.0.32 之前版本对NULLJSON 字段不触发编辑器 - Linux：界面卡顿 → 关闭「自动调整列宽」（设置 → 首选项 → 表格 → 取消勾选），该功能在 JSON 字段较多时易导致 GTK 渲染阻塞
- 所有平台：内容超长（> 1MB）会静默降级为文本模式 → 先用
JSON_EXTRACT(data, '$.user.profile')截取子路径预览，确认结构后再全量编辑
跨平台导入 JSON 文件时，字段映射失败的真正原因
你看到的「字段映射界面」其实是 Navicat 在客户端解析 JSON 后生成的 key 列表，它不经过数据库，因此大小写、空格、特殊字符是否匹配，完全取决于本地系统的行为差异：
- Windows 默认文件系统不区分大小写，但 Navicat 映射逻辑严格区分 —— 若 JSON 中是
"UserName"，而表列为username，不会自动关联，必须手动拖拽 - macOS 上用 TextEdit 保存的 JSON 文件默认带 BOM，即使显示为 UTF-8，Navicat 也会解析失败或丢第一行；务必用 VS Code 或 Sublime Text 保存为「UTF-8 无 BOM」
- Linux 终端导出的 JSON 常含
\r\n或\n混用，Navicat v16.0.17 之前版本在解析换行符时会截断数组，导致只导入前几条 - 目标列为
TINYINT(1)（常用于布尔），但 JSON 中写的是"is_active": true→ Navicat 不做类型转换，直接报错；必须改为"is_active": 1
修改现有字段为 JSON 类型，不能靠可视化界面点选
无论你在哪个平台使用 Navicat，「设计表」界面里的字段类型下拉框，对已有字段**永远不显示 JSON 选项**。这不是 Bug，而是设计限制：Navicat 不会为你执行 ALTER TABLE ... MODIFY COLUMN 这类 DDL 操作。
正确做法是手动写 SQL 并执行：
- 先确认数据库版本：
SELECT VERSION()，MySQL 必须 ≥5.7.8，PostgreSQL ≥9.4 - 备份数据：
CREATE TABLE users_bak AS SELECT * FROM users; - 执行变更：
ALTER TABLE users MODIFY COLUMN meta JSON;（MODIFY COLUMN比CHANGE COLUMN更安全，不用重复写字段名） - 注意：若原字段有索引，MySQL 会自动删除并重建，但外键约束需手动处理；
JSON字段在 MySQL 8.0.13+ 才支持DEFAULT '{}'::json，旧版只能设DEFAULT NULL
跨平台最易忽略的一点：不同操作系统对 SQL 脚本换行符的处理不同。Windows 写的 .sql 文件若含 \r\n，在 Linux 下用 Navicat 执行可能卡在第二行；建议统一用 \n，或直接在 Navicat 查询窗口中粘贴执行。
