JsonLite Selection Formatter

一个面向 C 代码中 JsonLite 写法的专用格式化插件。
它会在选区内识别 JsonLite_Init ... JsonLite_Finish 块，做结构化格式整理、规范诊断与有限自动修复。

插件简介

• 目标：让 JsonLite 代码更整齐、更一致、更容易排查错误。
• 原则：优先保持语义不变，只处理结构、缩进、空白与可识别的错误修复。
• 适用场景：key_name / val_* / Object_Begin / Array_Begin 风格的 C 代码片段。

主要能力

• 识别并按层级处理 JsonLite_Init / JsonLite_Finish、Object_Begin / Object_End、Array_Begin / Array_End
• 自动合并：
  • key_name(...); + 下一条 val_* / Object_Begin / Array_Begin 为同一行
• 分段对齐：
  • 同层级、同段内 key_name + val_* 按最长 key_name 对齐
• 结构诊断（红黄分级）：
  • 红色：结构损坏、关键 API 拼写/大小写错误、关键语义风险
  • 黄色：空白/空行/样式类问题
• 有限自动补全：
  • 对缺失值或缺失结束符进行自动补全，并追加 // [JsonLite-AUTO-FILL] 注释

使用方式

1. 在编辑器中选中 JsonLite 代码（可选中局部，插件会自动扩展到所属 JsonLite 块）。
2. 执行命令：
   • 右键菜单：JsonLite：格式化选中代码
   • 快捷键：Ctrl+Alt+J

诊断提示说明

• 看到红色提示时，优先修复结构问题（如开闭不平衡、关键 API 拼写错误）。
• 看到黄色提示时，可直接使用快捷键自动整理。
• 鼠标移入提示可查看具体修复建议。

本地调试

1. 在 VSCode 打开本项目。
2. 进入“运行和调试”，选择 Run JsonLite Extension。
3. 按 F5 打开 Extension Development Host。
4. 在新窗口内选中代码，按 Ctrl+Alt+J 测试。

发布流程（Marketplace）

1) 准备发布信息

确认 package.json 关键字段正确：

• name
• publisher（例如：izcw）
• version（每次发布都要递增）
• engines.vscode
• license
• description

2) 安装发布工具

npm install -g @vscode/vsce

3) 本地打包验证

vsce package

会生成 .vsix 文件，可本地安装验证：

code --install-extension jsonlite-selection-formatter-<version>.vsix

4) 创建发布者与 Token

1. 打开 Visual Studio Marketplace 管理页
2. 创建 Publisher（名称需与 package.json.publisher 一致）
3. 创建 PAT（权限包含 Marketplace 管理）

5) 登录并发布

vsce login izcw
vsce publish

版本自动递增也可用：

vsce publish patch

常见问题

• 命令没显示
  • 请确认有选中内容，且选区包含 JsonLite 相关语句。
• 快捷键无效
  • 检查 Ctrl+Alt+J 是否与其它命令冲突。
• 修改后不生效
  • 停止调试后重新 F5。
• 发布失败
  • 检查 publisher、version 是否正确，PAT 是否有权限。