Sublime中JSON转YAML失败因原生不支持且依赖插件与PyYAML包；需pip install pyyaml，选中文本操作，并配置default_flow_style=False等参数控制格式；YAML转JSON时须处理datetime、锚点等特有语法。
Sublime 里 JSON 转 YAML 为什么总失败？
因为 Sublime Text 原生不支持 JSON/YAML 格式互转，所有“一键转换”功能都依赖插件，而多数人装了插件却没配好解析器或没选中有效文本范围。
常见错误现象：YAML conversion failed: No module named 'yaml' 或转换后字段全变成字符串、时间戳被转成科学计数法、null 变成 ~ 等——本质是底层 Python 解析器行为未对齐。
- 必须安装
YAMLPython 包（不是插件名，是 pip install 的包）：在终端运行pip install pyyaml - 插件如
ConvertJsonYaml或YAML Tools依赖 Sublime 自带的 Python 环境，macOS/Linux 通常没问题；Windows 用户若用 Anaconda 或其他 Python，得确认 Sublime 调用的是哪个python - 选中文本再触发命令，不能只把光标停在文件里——否则插件默认读取整个文件，而 JSON/YAML 混合内容（比如带注释的 YAML 或 JS 对象字面量）会直接报错
JSON → YAML 实操要点：缩进、引号与 null 怎么控制？
YAML 没有标准“格式化输出规范”，不同解析器对相同输入可能生成不同结果。PyYAML 默认行为就容易踩坑：
-
default_flow_style=False必须开启，否则嵌套对象会压成一行（如{a: {b: c}}） -
allow_unicode=True才能保留中文不转义成\u4f60 -
width=1000防止长字符串自动换行加|或>—— 这个值太小会导致 YAML 可读性反而下降 -
null在 YAML 中默认输出为~，但有些工具（如 Ansible）更认null字面量，需手动替换或改用yaml.Dumper自定义表示
示例（PyYAML 关键参数）：
yaml.dump(data, default_flow_style=False, allow_unicode=True, width=1000)
YAML → JSON 时日期、锚点、标签怎么处理？
YAML 支持 JSON 完全没有的语法特性，比如 !!timestamp、&anchor、*anchor、!!python/tuple，这些在转 JSON 时必然丢失或报错。
真实使用场景：你拿到一份带 created_at: 2023-01-01 的 YAML，想喂给前端 JSON API——表面看是日期，但 PyYAML 默认把它当 datetime 对象，JSON encoder 会直接抛 TypeError: Object of type datetime is not JSON serializable。
- 先用
yaml.load(..., Loader=yaml.CSafeLoader)（安全加载，禁用任意 tag） - 遍历数据结构，把
datetime转成isoformat()字符串，把None显式转成None（避免变成~后又被忽略） - 锚点/引用（
&id/*id）会被 PyYAML 自动解引用，转出的 JSON 是展开后的副本，不是引用关系——这点必须提前确认业务是否允许 - 含单引号/双引号的字符串在 YAML 里可省略引号，但转 JSON 后一律加双引号，无需干预
别依赖 Sublime 插件做生产级格式转换
插件适合快速预览或本地调试，但一旦涉及 CI/CD、配置下发或多人协作，就得切到命令行或脚本里做可控转换。
原因很实在：Sublime 插件无法统一团队环境（有人装了 pyyaml，有人没装；有人用 Python 3.9，插件调用的是 3.8）；也无法接入校验流程（比如转完立刻跑 jsonschema 验证）；更没法处理大文件（Sublime 加载 >5MB 文件就卡）。
真正省事的做法：写个两行脚本，用 python -c "import yaml, json; print(json.dumps(yaml.safe_load(open('a.yaml')), indent=2))"，加到 Makefile 或 pre-commit 钩子里——路径、编码、错误提示全在自己手里。
