sublime text需通过插件实现保存自动格式化：jsprettier用于js/ts/json，依赖本地prettier cli，须安装node.js和prettier并正确配置prettier_cli_path及auto_save；python用black需pip安装black并设置black_cmd路径，开启on_save；常见失败原因为cli路径错误、环境变量不一致或语法类型不匹配。
Sublime Text 本身不内置保存时自动格式化功能，必须通过插件 + 正确配置才能实现；直接装插件不调参数，大概率会失效或报错。
怎么安装并启用 JsPrettier（JS/TS/JSON 场景）
这是最稳定、适配 Sublime 的格式化插件之一，依赖本地 prettier CLI，不是纯 Python 实现，所以需要提前装好 Node.js 和 Prettier。
- 用 Package Control 安装
JsPrettier，重启 Sublime - 终端执行
npm install -g prettier，确保prettier --version能输出版本号 - 检查
which prettier（macOS/Linux）或where prettier（Windows），把路径填进JsPrettier的用户设置里："prettier_cli_path" - 在
JsPrettier设置中开启"auto_save"并设为true，同时关掉"auto_display_output_panel"避免弹窗干扰
Python 文件用 Black 自动格式化要配什么
不能只装 SublimeBlack 插件，它只是包装器，底层靠系统 Python 环境里的 black 命令。路径、权限、Python 版本都得对得上。
- 用
pip install black安装（推荐在项目虚拟环境中装，再把该环境的black路径写进插件设置） -
SublimeBlack设置里必须指定"black_cmd"，比如"/path/to/venv/bin/black"（macOS/Linux）或"C:\venv\Scripts\black.exe"（Windows） - 保存触发格式化的开关是
"on_save"，设为true；若想跳过某些文件，用"excluded_dirs"或"excluded_files" - 注意：如果用了 pyenv 或 conda，
black可能不在默认 PATH，插件找不到就会静默失败，无任何提示
为什么保存后没反应？常见断点排查
自动格式化挂掉，90% 是路径或权限问题，不是插件坏了。
- 插件设置里写的 CLI 路径是否真实存在？用终端直接运行试试，比如
prettier --write test.js - Sublime 启动方式影响环境变量：从桌面图标启动，可能读不到 shell 的 PATH；建议从终端执行
subl打开，或手动在插件设置里补全完整路径 - 文件语法类型是否匹配？Sublime 右下角显示的是
JavaScript还是JavaScript (Babel)？后者JsPrettier默认不处理，需在设置里加"syntaxes"扩展支持 - 保存时有语法错误（比如 JS 少了个括号），
prettier会直接退出，不会格式化——这不是 bug，是它的设计逻辑
真正麻烦的不是装插件，而是让 CLI 工具、Sublime 环境、项目配置三者对齐；路径写错一个字符，或 Python 环境切错一次，就白配半小时。
