codeformatter插件在sublime text 4中基本不可用，因其自2025年11月起停止维护，未适配python 3.8及新api，导致importerror、菜单缺失、配置失效等静默失败；推荐改用build system调用prettier/black/php-cs-fixer等本地工具。
CodeFormatter 插件在当前 Sublime Text 4（2026 年主流版本）下**基本不可用**，不是安装问题，而是底层已失效。
它自 2018 年起停止维护，最后更新停留在 2025 年 11 月，且未适配 ST4 的 Python 3.8 运行时和新 API。你装上后大概率遇到：ImportError: No module named 'urllib2'、右键无菜单、快捷键无响应、配置不生效——这些不是你配错了，是插件本身跑不起来。
为什么 CodeFormatter 在 ST4 中会静默失败
插件内部大量硬编码依赖旧版工具链和 Python 2 语义：
-
php-cs-fixer调用仍指向 v1.x 版本，而现代 PHP 项目普遍用 v3.x，规则名（如@PSR12）和 CLI 参数已不兼容 -
js-beautify封装层还在用已废弃的--indent-level参数，新版 prettier / js-beautify v3+ 已移除 - Windows 下调用
gofmt或php时，若路径含空格或中文，subprocess.Popen直接抛UnicodeEncodeError: 'mbcs' codec can't encode，且无 fallback 机制 - Python 格式化走的是
PythonTidy，该工具早已归档，import pytidy在 Python 3.8+ 必报ModuleNotFoundError
CodeFormatter.sublime-settings 配置为何总不生效
即使你手动写对了 "psr2": true 或 "indent_size": 2，也大概率白费——因为引擎根本没加载成功：
- Sublime 启动时的
PATH环境变量 ≠ 终端里的PATH（尤其 macOS GUI 应用），php -v在终端能跑，但在 Sublime 控制台执行view.window().run_command("exec", {"cmd": ["php", "-v"]})却报错，说明插件根本找不到 PHP -
"psr2": true必须搭配"enable_auto_align": true才触发等号对齐；单独开psr2只改花括号换行和空格，结构对齐不会动 - 项目根目录下存在
.php_cs或php-cs-fixer.php时，phpF引擎会静默覆盖你的插件配置，且无法关闭该行为
真正可用的替代方案：用 Build System 调用本地 formatter
Sublime Text 本身不格式化代码，但可以稳定调度你本地装好的权威工具：
- JavaScript/TypeScript：
prettier --write $file（需npm install -g prettier） - Python：
black $file --line-length 88（推荐，避免默认 88 行被截断） - PHP：
php-cs-fixer fix $file --rules=@PSR12（必须用 v3.x，别用 CodeFormatter 自带的 phar） - HTML/CSS：
js-beautify -f $file -o $file（注意 v3+ 的参数写法，-f不是--file）
关键点：Build System 必须设置 "selector": "source.js, source.ts, source.python, source.php"，否则右键菜单不显示 “Build” 选项；快捷键建议设为 ctrl+alt+l，与主流 IDE 一致。
如果你非要用 CodeFormatter（仅限离线旧项目）
这不是推荐，而是妥协方案，仅适用于无协作、不升级、不碰现代语法的封闭环境：
- 降级到
Sublime Text 3.2.2（最后兼容版本），并禁用自动更新 - 所有 formatter 工具（
php、node、python）必须装在无空格、无中文的路径下 - 不要处理 ES2020+（如
a?.b）、PHP 8.0+（如属性类型声明）、Python 3.12（如match表达式）——格式化大概率破坏语法或缩进
真正的麻烦不在安装，而在“它看似在运行，实则在 silently fail”。现代项目里，靠它保格式一致性，等于拿胶带修高压线。
