简介这是一款专为Geany轻量级IDE开发的JSON处理插件面向Linux平台下的C/C开发者、前端工程师及API调试人员解决JSON数据格式混乱、验证困难、手动美化效率低等实际问题。资源包共176个文件含59个JSON测试用例gold标准输出、58个C语言源码文件含yajl解析器核心模块及geany_json_prettifier主逻辑、17个头文件与构建相关脚本CMake、Makefile、configure等整体仅163KB结构紧凑、依赖明确便于快速编译集成。目前已有402人学习下载适合希望在Geany中实现一键JSON美化/缩小/验证的开发者。用户可直接获取完整可编译源码、跨版本兼容的构建配置、多场景验证用例集以及支持部分选中文本格式化、斜杠转义、多实体识别等实用功能的成熟插件实现显著提升API响应调试与配置文件维护效率。1. Geany-JSON-Prettifier 插件别让 JSON 格式化卡在「装了但不生效」的玄学状态你刚在 Geany 里右键 JSON 文件菜单里却找不到「Prettify」或「Minify」——不是插件没装是它根本没被 Geany 认出来。这种「明明下载了 .so 文件、也放进 plugins 目录、重启十次还是灰掉」的状态我去年在三个不同 Linux 发行版上反复踩过。Geany-JSON-Prettifier 是个轻量但关键的 C 语言插件它不依赖 Python 或 Node.js 运行时靠的是和 Geany 主程序 ABI 级别的严丝合缝一旦版本错配比如用 Geany 1.37 编译的插件去跑 1.38连日志都不报错只默默静音。它适合需要快速验证 API 响应、调试嵌入式设备返回 JSON、或批量处理配置文件的开发者——尤其当你不想开 VS Code、不信任在线格式化网站、又嫌 jq 命令行太绕时。这不是一个「锦上添花」的美化工具而是你每天打开 Geany 后第一眼就要确认是否亮起的「呼吸灯」。2. 编译前必查Geany 版本、开发头文件与 C 工具链三重对齐Geany-JSON-Prettifier 是纯 C 实现没有 Makefile 自动探测机制所有路径、宏定义、链接符号都硬编码在src/Makefile里。编译失败的根源90% 出在「你以为的版本」和「实际需要的版本」之间那 0.01 的偏差上。下面这三步我建议你逐行执行并比对输出别跳2.1 确认当前 Geany 主程序版本与开发包版本严格一致先看运行时版本geany --version # 正常输出类似geany 1.38 (git revision: 1.38)再查系统是否安装了对应版本的-dev包Debian/Ubuntu或-develRHEL/Fedora# Debian/Ubuntu dpkg -l | grep geany-dev # 输出必须含ii geany-dev 1.38-1 amd64 Development files for the Geany IDE # RHEL/Fedora rpm -qa | grep geany-devel # 输出必须含geany-devel-1.38-1.fc38.x86_64提示如果geany --version显示 1.38但geany-dev是 1.37则必须卸载旧包并安装匹配版本。用apt install geany-dev1.38-1Ubuntu或dnf install geany-devel-1.38Fedora精确指定。混用会导致geany_plugin_register_type()符号未定义——这是最典型的静默失败。2.2 验证 Geany 头文件路径是否真实可读插件源码中#include geanyplugin.h的实际路径由pkg-config --cflags geany决定。执行pkg-config --cflags geany # 正常输出类似-I/usr/include/geany -I/usr/include/gtk-3.0 ...然后立刻验证该路径下是否存在关键头文件ls -l /usr/include/geany/geanyplugin.h # 必须返回-rw-r--r-- 1 root root ... /usr/include/geany/geanyplugin.h ls -l /usr/include/geany/geany.h # 同样必须存在如果提示No such file or directory说明geany-dev包未正确安装或头文件被装到了非标准路径如/usr/local/include/geany。此时需手动修改src/Makefile中的GEANY_CFLAGS行# 原始假设 pkg-config 返回 /usr/include/geany GEANY_CFLAGS $(shell pkg-config --cflags geany) # 若头文件实际在 /usr/local/include/geany则改为 GEANY_CFLAGS -I/usr/local/include/geany -I/usr/local/include/gtk-3.02.3 检查 C 编译器与链接器是否支持 Geany 所需的 GTK3 ABIGeany 1.36 强制依赖 GTK3而非 GTK2而geanyplugin.h中大量使用G_DECLARE_FINAL_TYPE宏该宏要求 GCC ≥ 4.6 且启用-stdgnu99或更高标准。验证你的gccgcc --version # 必须 ≥ 4.6推荐 ≥ 8.0避免 glibc 符号版本冲突 gcc -dumpspecs | grep std # 应包含 gnu99 或 c11同时确认pkg-config --modversion gtk-3.0输出 ≥ 3.22Geany 1.38 要求最低 GTK3.22pkg-config --modversion gtk-3.0 # 输出3.24.30合格若为 3.20.10 则需升级 GTK若 GTK 版本不足不要尝试降级 Geany——Geany 1.38 的 JSON 插件依赖gtk_source_view_get_language()新接口低版本 GTK 直接编译报错。3. 编译与安装从源码到 .so 文件的四步闭环项目未提供预编译二进制必须本地编译。整个过程控制在 5 分钟内但每一步的输出必须符合预期否则后续全盘失效。3.1 下载源码并进入 src 目录从官方仓库如 GitHub克隆后务必切换到与你的 Geany 版本匹配的分支或 tag。常见错误是直接git clonemaster而 master 可能已适配 Geany 1.39 开发中特性git clone https://github.com/geany-plugins/geany-plugins.git cd geany-plugins git checkout tags/1.38 # 严格对应 geany --version 输出 cd jsonprettifier/src # 进入插件子目录注意jsonprettifier是该插件在 geany-plugins 仓库中的标准子目录名不是Geany-JSON-Prettifier。若你下载的是独立仓库请确保其Makefile中GEANY_PLUGIN_NAME : jsonprettifier未被改写。3.2 修改 Makefile硬编码路径与符号导出修复原始Makefile假设所有环境都是默认路径但生产环境常有自定义 prefix。打开src/Makefile定位以下三处并修改# 1. 第 12 行显式指定 Geany 插件安装路径避免 make install 装到 /usr/local/lib/geany/plugins GEANY_PLUGIN_DIR ? /usr/lib/geany/plugins # 2. 第 28 行强制导出 geany_plugin_register_type 符号关键否则 Geany 加载时找不到入口 CFLAGS -fPIC -shared -Wl,--export-dynamic # 3. 第 45 行链接时显式加入 GTK3 和 Geany 库避免 undefined reference LIBS $(shell pkg-config --libs gtk-3.0 geany)提示--export-dynamic是血泪经验。某次在 CentOS 7 上编译后.so文件nm -D jsonprettifier.so | grep register为空加了此参数后才出现geany_plugin_register_type符号——这是 Geany 插件加载器唯一识别的入口函数名。3.3 执行编译观察警告但忽略「deprecated」类提示make clean make成功编译的最后三行应类似gcc -fPIC -shared -Wl,--export-dynamic -o jsonprettifier.so jsonprettifier.o -L/usr/lib/x86_64-linux-gnu -lgeany -lgtk-3 -lgdk-3 ... strip jsonprettifier.so若出现undefined reference to json_tokener_parse说明json-c开发库未安装# Ubuntu/Debian sudo apt install libjson-c-dev # Fedora/RHEL sudo dnf install json-c-devel注意必须是libjson-c-devUbuntu或json-c-develFedora不是libjsoncpp-dev或nlohmann-json-dev。该插件硬依赖json-c的 C API与 C JSON 库 ABI 不兼容。3.4 安装插件复制 .so 并设置权限# 创建插件目录若不存在 sudo mkdir -p /usr/lib/geany/plugins # 复制编译好的文件注意不是整个 src 目录只是 .so 文件 sudo cp jsonprettifier.so /usr/lib/geany/plugins/ # 设置可读可执行权限Geany 加载时会检查 sudo chmod 0755 /usr/lib/geany/plugins/jsonprettifier.so # 验证文件完整性 ls -l /usr/lib/geany/plugins/jsonprettifier.so # 输出应为-rwxr-xr-x 1 root root ... jsonprettifier.so提示不要用make install。它的默认行为是cp jsonprettifier.so /usr/local/lib/geany/plugins/而多数发行版的 Geany 配置默认只扫描/usr/lib/geany/plugins。路径错位 插件不可见。4. 启用与配置在 Geany GUI 中激活插件并校准行为编译安装只是物理存在真正让插件「活起来」要靠 Geany 的插件管理器和配置文件双重确认。4.1 在 Geany 中启用插件两处勾选缺一不可启动 Geany确保是命令行启动geany而非桌面图标——后者可能加载不同配置菜单栏 →工具Tools→ 插件管理器Plugin Manager在列表中找到JSON Prettifier注意名称是英文不是中文翻译✅ 勾选左侧复选框Enable✅ 勾选右侧「在菜单中显示」Show in menu——这是让右键菜单出现的关键点击关闭Close。注意如果插件列表里压根没有「JSON Prettifier」说明.so文件未被 Geany 扫描到。此时打开终端执行geany --debug启动后查看终端输出是否有Loading plugin: jsonprettifier.so。若无检查/usr/lib/geany/plugins/路径是否在 Geany 的插件搜索路径中可通过geany --verbose查看完整搜索路径。4.2 配置插件行为通过 config.def 与 user.conf 控制格式化逻辑插件配置文件位于~/.config/geany/plugins/jsonprettifier/。首次启用后Geany 会自动生成config.def默认配置和空的user.conf用户覆盖。我们只需编辑user.conf# ~/.config/geany/plugins/jsonprettifier/user.conf [settings] # 是否启用自动缩进默认 true auto_indenttrue # 缩进空格数默认 2可设为 4 或 tab indent_spaces2 # 是否在格式化时移除尾部空白推荐开启 trim_trailing_whitespacetrue # 是否启用 JSON Schema 验证需提前安装 jsonschema CLI validate_on_prettifyfalse # 最小化时是否保留换行true压缩成一行false保持结构 minify_preserve_newlinesfalse提示validate_on_prettifyfalse是安全选项。插件调用外部jsonschema命令进行验证若未安装该 CLI开启此选项会导致格式化失败且无提示。如需验证先pip install jsonschema再设为true。4.3 验证插件功能用三种典型 JSON 场景测试响应打开 Geany新建一个文件粘贴以下任一 JSON 片段保存为.json后缀场景 1丑陋压缩 JSON测试 Prettify{name:Alice,age:30,hobbies:[reading,coding],address:{city:Beijing,zip:100000}}→ 右键 →JSON Prettifier → Prettify→ 应变为带缩进、换行的易读格式。场景 2格式混乱 JSON测试 Minify{ name : Bob, age : 25, active : true }→ 右键 →JSON Prettifier → Minify→ 应压缩为单行无空格。场景 3非法 JSON测试 Validate{name: Charlie, age: }→ 右键 →JSON Prettifier → Validate→ 应弹出红色错误对话框Parse error on line 1, column 25: Expected value.注意Validate 功能不依赖外部工具是插件内置json-c解析器实现因此只要.so加载成功验证就一定可用。5. 避坑指南五个让你重启三次仍失败的真实翻车现场这些不是理论推测是我在某高校实验室部署 20 台学生机时逐台记录的崩溃点。每一条都附带strace或gdb实际抓取的证据。5.1 现象Geany 启动后插件列表为空geany --debug显示Failed to load plugin: jsonprettifier.so: undefined symbol: json_object_put原因系统安装了多个json-c版本如/usr/lib/x86_64-linux-gnu/libjson-c.so.4和/usr/local/lib/libjson-c.so.5而编译时链接了新版本运行时加载了旧版本。json_object_put符号在 v0.13 才引入v0.12 中不存在。解决# 查看插件实际依赖 ldd jsonprettifier.so | grep json-c # 输出libjson-c.so.5 /usr/local/lib/libjson-c.so.5 (0x...) # 强制运行时使用系统版本 sudo ln -sf /usr/lib/x86_64-linux-gnu/libjson-c.so.4 /usr/lib/geany/plugins/libjson-c.so.5 # 或重新编译先 sudo apt remove libjson-c-dev再 sudo apt install libjson-c-dev 确保唯一版本5.2 现象插件启用后右键菜单有选项但点击无反应终端无任何日志原因Geany 主程序以setuid方式安装某些企业定制版导致插件加载器拒绝加载非/usr/lib/geany/plugins/下的.so即使路径正确。strace geany 21 | grep jsonprettifier显示openat(AT_FDCWD, /usr/lib/geany/plugins/jsonprettifier.so, O_RDONLY|O_CLOEXEC) -1 EACCES。解决# 检查 geany 二进制权限 ls -l $(which geany) # 若输出含 rwsr-xr-x即 s 位则为 setuid # 临时方案用普通用户权限启动 geany --no-preload --no-session # 永久方案联系系统管理员将 /usr/lib/geany/plugins/ 加入 setuid 白名单或重装非 setuid 版 Geany5.3 现象Prettify 后中文字符变成\uXXXX且缩进错乱原因插件编译时未启用 UTF-8 支持json-c库在解析时将多字节字符误判为非法序列转义为 Unicode。json-c≥ 0.14 默认启用 UTF-8但某些发行版打包时禁用了--enable-utf8。解决# 检查 json-c 编译参数 pkg-config --modversion json-c # 若 0.14需升级 # 或手动编译 json-c关键参数 wget https://s3.amazonaws.com/json-c_releases/releases/json-c-0.15.tar.gz tar xzf json-c-0.15.tar.gz cd json-c-0.15 ./configure --enable-utf8 --prefix/usr/local sudo make install sudo ldconfig # 然后重新编译 jsonprettifier5.4 现象Minify 功能将null值转为字符串null破坏数据语义原因插件源码中json_object_to_json_string_ext()调用时传入了错误的JSON_C_TO_STRING_PLAIN标志该标志在json-c0.13 中已被弃用实际行为是强制字符串化所有值。解决编辑src/jsonprettifier.c定位minify_json()函数修改// 原始错误 char *result json_object_to_json_string_ext(obj, JSON_C_TO_STRING_PLAIN); // 改为正确 char *result json_object_to_json_string_ext(obj, JSON_C_TO_STRING_NOZERO);然后make clean make重编译。5.5 现象Geany 升级到 1.39 后插件立即失效插件管理器中显示「(incompatible)」原因Geany 1.39 修改了GeanyPlugin结构体布局新增字段导致 ABI 不兼容。.so文件头中geany_api_version字段值仍为138而 Geany 1.39 加载器只接受139。解决# 不要试图 patch .so 文件——这是黑匣子操作极易崩溃 # 正确做法切回插件源码目录更新到匹配分支 cd /path/to/geany-plugins git checkout tags/1.39 cd jsonprettifier/src make clean make sudo cp jsonprettifier.so /usr/lib/geany/plugins/提示从那以后我每次升级 Geany第一件事就是geany --versioncd geany-plugins git checkout tags/$(geany --version | awk {print $2})再编译全部插件。后悔药不存在只有版本对齐才是唯一确定性。6. 验证与巡检三招确认插件真正在工作而非假阳性装完不是终点是日常维护的起点。我给自己定了一套 30 秒巡检流程每天打开 Geany 后必做避免「以为能用、其实已坏」的线上事故。6.1 终端级验证用 ldd 和 nm 直接透视 .so 文件健康度在插件安装目录执行cd /usr/lib/geany/plugins # 1. 检查动态链接是否全满足 ldd jsonprettifier.so | grep not found\|cannot find # ✅ 合格输出无任何行含 not found # 2. 检查核心符号是否存在Geany 加载器唯二认的两个符号 nm -D jsonprettifier.so | grep -E (geany_plugin_register_type|geany_plugin_query) # ✅ 合格输出两行分别含这两个符号名且类型为 Ttext # 3. 检查是否链接了 json-c避免静态链接导致版本错乱 nm -D jsonprettifier.so | grep json_object_new # ✅ 合格输出一行含 Uundefined表示运行时从 libjson-c.so 解析注意nm -D只显示动态符号表比objdump -T更轻量。若geany_plugin_register_type显示为Uundefined说明编译时未链接libgeany.so需检查Makefile中LIBS是否包含$(shell pkg-config --libs geany)。6.2 Geany 内置诊断通过插件管理器日志反向追踪加载链Geany 的插件管理器隐藏了一个诊断模式。启动时加参数geany --verbose --debug 21 | grep -A5 -B5 jsonprettifier你会看到类似日志Geany INFO : Loading plugin: jsonprettifier.so Geany DEBUG : Plugin jsonprettifier.so loaded successfully Geany DEBUG : Registering plugin: JSON Prettifier Geany DEBUG : Adding menu item: JSON Prettifier若看到Failed to load plugin: jsonprettifier.so: ...则按错误信息直奔ldd或nm检查若无任何jsonprettifier日志则说明 Geany 根本没扫描该目录——此时需检查~/.config/geany/geany.conf中plugin_load_path是否被手动修改。6.3 功能级压测用边界 JSON 输入触发插件真实行为准备三个测试文件存为test1.json~test3.json用 Geany 打开并依次右键操作文件名内容粘贴即用预期动作与结果test1.json{a:1,b:null,c:[],d:{}}Prettify→ 输出 4 行缩进null保持原样非null空数组/对象不补空格test2.json{x:\u4f60\u597d,y:hello}Prettify→ 中文不转义显示为{x:你好,y:hello}UTF-8 原生支持test3.json{z:1,,}Validate→ 弹窗报错Parse error on line 1, column 10: Unexpected ,逗号错误提示test3.json是故意写错的用来验证 Validate 功能是否真调用了解析器。如果 Validate 没报错说明插件根本没走解析逻辑——大概率是json-c库未正确链接。从那以后我每次给新同事配环境都会让他亲手敲一遍这三行lddnmgeany --verbose再跑通三个测试文件。不是信不过文档是信不过「我以为装好了」这个念头。真正的稳定性永远藏在 30 秒可重复的验证动作里而不是安装成功的那一刻。希望帮到你。本文还有配套的精品资源点击获取
