Sublime 运行环境 JSON 参数配置指南

夜宇同学_9585

夜宇同学_9585

2026-11-19

411人浏览

原创

Sublime Text JSON格式化失败的三大主因是:状态栏未设为JSON语法、文件含UTF-8 BOM、缩进配置未固定为2空格且detect_indentation未关闭;需手动切换语法、重编码为UTF-8、并在HTML-CSS-JS Prettify中设"indent_size": 2与"detect_indentation": false。

sublime 运行环境 json 参数配置指南

Sublime Text 本身不运行 JSON,它只是编辑和格式化 JSON;所谓“运行环境 JSON 参数配置”,实际是指:如何让 Sublime 正确识别、解析、格式化、保存 JSON 文件——这依赖三类配置协同生效:编辑器全局设置(Preferences.sublime-settings)、插件专属配置(如 HTML-CSS-JS Prettify.sublime-settings)、以及文件级元信息(编码、语法类型、缩进风格)。缺一不可,任一错配都会导致 Ctrl+Alt+J 静默失败、中文变 \u4f60\u597d、或报 Unexpected token 却找不到错在哪。

为什么 JSON 文件右下角显示 Plain Text 就格式化不了

Sublime 所有 JSON 相关命令(包括 Pretty JSON: Format JSON 和 html_css_js_prettify)都依赖语法作用域(source.json)触发。状态栏显示 Plain Text 意味着 Sublime 根本没把当前文件当 JSON 解析,后续所有格式化逻辑都不会执行。

  • 点击右下角状态栏的 Plain Text,手动选 JSON;或按 Ctrl+Shift+P 输入 Set Syntax: JSON 回车
  • 如果菜单里没有 JSON 选项,说明你还没装 JSON 语法包:用 Package Control: Install Package 装 JavaScript Next 或官方 JSON 包(后者已内置在 ST4 中,但有时需手动启用)
  • 临时验证:新建文件 → 粘贴 {"a":1} → 保存为 test.json → 看状态栏是否自动切到 JSON;若仍为 Plain Text,说明文件扩展名未被正确映射,需进 Preferences → Settings – Syntax Specific 手动加 "syntax": "Packages/JavaScript/JSON.sublime-syntax"

UTF-8 with BOM 是 JSON 格式化的隐形杀手

js-beautify(HTML-CSS-JS Prettify 底层引擎)和 simplejson(Pretty JSON 底层)均无法容忍 UTF-8 BOM。一旦文件含 BOM,解析器会直接跳过校验、不报错、不格式化,光标卡住不动——这是最常被忽略的失败原因。

  • 打开文件 → File → Reopen with Encoding → UTF-8(不是 UTF-8 with BOM)
  • 保存前务必再确认:菜单 File → Save with Encoding → UTF-8
  • 批量清理 BOM:用 Find → Find in Files 搜索 \x{FEFF}(正则模式),替换为空,范围限定为 *.json
  • 预防:在用户设置中加 "default_encoding": "UTF-8",并禁用任何可能写入 BOM 的插件(如旧版 ConvertToUTF8)

indent_size=2 和 detect_indentation=false 必须同时设

JSON RFC 明确推荐缩进为 2 空格,但 Sublime 默认是 4;更麻烦的是,HTML-CSS-JS Prettify 默认开启 detect_indentation,它会扫描文件前几行猜缩进宽度——结果常把 2 空格的 JSON 误判成 4 空格,格式化后混入 Tab,Git diff 爆炸。

Json To Jianying Description
Json To Jianying Description

将包含oralBroadcastingList、materialList、bgmInfo等字段的JSON视频素材转换为剪映API可用的自然语言描述,用于生成视频制作指令,包括素材匹配、时间轴计算、字幕同步、特殊效果处理等。

下载
  • 进 Preferences → Package Settings → HTML-CSS-JS Prettify → Settings,确保含以下两项:
  • "indent_size": 2
  • "detect_indentation": false
  • 额外加固:在全局 Preferences.sublime-settings(右侧用户面板)加 "tab_size": 2 和 "translate_tabs_to_spaces": true,再对当前文件执行 View → Indentation → Convert Indentation to Spaces
  • 别信“自动检测”——JSON 不是 JS,没有缩进灵活性;固定值 + 强制转换才是唯一可靠路径

插件选 HTML-CSS-JS Prettify,不是 Pretty JSON

截至 2026 年底,Pretty JSON 在 ST4 上仍频繁抛 ImportError: No module named 'sublime',因其底层绑定的是 ST3 的 Python 2.6 运行时;而 HTML-CSS-JS Prettify 已全面适配 ST4 的 Python 3.8+ 环境,且支持 ensure_ascii: false 直出中文、能修复缺失逗号、可报告具体行号错误。

  • 安装后必须进其 Settings 文件,显式写入:"json": true(默认虽为 true,但某些安装渠道会漏掉)
  • 快捷键绑定必须加 context 限定,否则对 JS 文件也触发,破坏原始语义:{"key":"selector","operator":"equal","operand":"source.json"}
  • 禁用 on_save 自动格式化:JSON 配置文件常含密钥、路径等敏感字段,自动重排可能掩盖拼写错误(如 "url" 错打成 "ulr"),人工触发更安全

真正卡住人的从来不是功能不会用,而是状态栏没切对语法、编码带了 BOM、缩进被插件自己猜歪——这三处不亲手检查一遍,装十个插件也没用。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

5136

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

1475

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1958

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

10663

11

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1080

4

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3284

5

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.14

1689

5

js截取字符串的方法介绍
js截取字符串的方法介绍

JavaScript字符串截取方法,包括substring、slice、substr、charAt和split方法。这些方法可以根据具体需求,灵活地截取字符串的不同部分。在实际开发中,根据具体情况选择合适的方法进行字符串截取,能够提高代码的效率和可读性 。

2023.09.21

5669

3

js生成随机数方法
js生成随机数方法

JavaScript生成随机数的方法,包括使用Math.random()方法生成指定范围内的随机整数、生成随机字符串和生成随机颜色。根据具体需求,可以选择适合的方法来生成随机数,以实现各种功能 。

2023.09.25

3315

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程