Sublime Text便携版与安装版功能一致，但格式化需手动配置绝对路径（如Windows填prettier.cmd）、插件设置仅限User目录、必须完全重启生效，且命令须通过Ctrl+Shift+P验证是否加载成功。
Sublime Text 便携版（Portable）和安装版在功能上完全一致，但格式化代码时路径、环境依赖、插件加载行为有关键差异——不改配置就直接套用网上教程，大概率点不动快捷键、调不起 prettier、甚至插件根本没加载。
便携版必须手动指定所有 CLI 工具的绝对路径
便携版不会读系统 PATH，插件如 JsPrettier、Sublime-Code-Formatter 默认找 prettier 或 black 命令会失败。你得填死路径，且必须是可执行文件全名：
- Windows 下
prettier_cli_path必须写成C:/portable/nodejs/prettier.cmd（注意斜杠方向、.cmd 后缀） - Python 的
black若放在便携目录下，路径就得是C:/portable/python/Scripts/black.exe - Mac/Linux 便携版同理：不能写
~/bin/prettier，得用/Users/xxx/portable/prettier这种展开后的绝对路径 - 路径里含空格（比如
Program Files）会导致调用失败，建议把 node.js 或 Python 放到C:/portable/node这类无空格路径
插件配置文件要改“User”而非“Default”，且不能依赖自动发现
便携版的 Packages/User/ 目录是唯一安全的写入位置，所有插件设置必须存这里：
-
JsPrettier设置入口是 Preferences → Package Settings → JsPrettier → Settings – User，粘贴 JSON 时确保是合法格式（逗号、引号、括号闭合） - 别碰
Settings – Default，它只读，改了也不生效 - 像
HTML-CSS-JS Prettify的缩进宽度、引号风格等，也必须在Settings – User里显式写"tab_width": 2，留空=用默认值，不是继承系统 - 改完配置必须**完全退出 Sublime 再重开**，便携版不热重载
快捷键冲突更隐蔽，优先用 Ctrl+Shift+P 手动验证命令是否注册
便携版常因插件加载顺序或缺失依赖导致命令未注册，快捷键按了没反应，但控制台（Ctrl+）不报错——这是最典型的假死现象：
- 先按
Ctrl+Shift+P，输入JsPrettier，看是否出现JsPrettier: Format Code选项；若没有，说明插件根本没加载成功 - 常见原因：插件 zip 包损坏、解压后文件夹名含空格或特殊字符（如
JsPrettier-master应改为JsPrettier）、依赖的 Python 版本不匹配 - 快捷键绑定要加
context，否则在 Plain Text 文件里也会触发并静默失败。例如只对 JS 生效，必须写"selector": "source.js" - 推荐初始调试用
Ctrl+Shift+P调命令，确认能跑通后再配快捷键
便携版的“便携”只体现在免安装，不代表免配置；所有路径、环境、插件状态都得自己钉死。最容易被忽略的是：插件安装后没重启编辑器，或把 .cmd 后缀漏掉——这两点占便携版格式化失败案例的七成以上。
