不推荐新项目启用 codeformatter。它自2018年起停止维护，依赖工具版本滞后，对es2020+、php 8.0、python 3.12等现代语法支持缺失或格式错误，且存在缩进破坏、参数弃用、路径兼容性及编码冲突等问题。
CodeFormatter 插件是否还值得在 Sublime Text 中使用？
不推荐新项目启用 CodeFormatter。它自 2018 年起停止维护，底层依赖的 php-cs-fixer、js-beautify 等工具版本严重滞后，对现代语法（如 ES2020+ 可选链、PHP 8.0 属性类型、Python 3.12 模式匹配）支持缺失或格式错误。实际测试中，CodeFormatter 在处理 async/await 嵌套或带装饰器的 Python 类时会破坏缩进逻辑。
替代方案：用 Sublime Text 原生能力 + 外部 formatter
Sublime Text 本身不内置多语言格式化，但可通过 Build System 调用本地已安装的权威 formatter，稳定且可控：
- JavaScript/TypeScript：用
prettier（需全局安装npm install -g prettier），新建 Build System 配置指向prettier --write $file - Python：用
black（pip install black），Build System 中写black $file，注意加--line-length 88避免默认 88 行被截断 - PHP：用
php-cs-fixer3.x（非CodeFormatter内置的 1.x），配置php-cs-fixer fix $file --rules=@PSR12 - 关键点：所有 Build System 必须勾选
"selector": "source.js, source.ts, source.python, source.php"，否则右键菜单不显示 “Build” 选项
为什么不能直接用 Package Control 安装 CodeFormatter 并修复？
即使手动替换插件里的 php-cs-fixer.phar 或更新 js-beautify 路径，也会触发以下问题：
-
CodeFormatter的 Python 封装层硬编码了旧版js-beautify的 CLI 参数（如--space-after-anonymous-function），新版已弃用该参数，导致命令执行失败并静默退出 - 插件配置文件
CodeFormatter.sublime-settings中的"php_cs_fixer_path"字段不支持数组路径 fallback，无法兼容不同系统下php-cs-fixer的安装位置（如 macOS Homebrew 在/opt/homebrew/bin/php-cs-fixer，Windows 在C:\Users\X\AppData\Roaming\npm\php-cs-fixer） - Sublime Text 4 的 Python 3.8 运行时与
CodeFormatter内嵌的旧版subprocess调用方式存在编码冲突，中文路径下会抛出UnicodeEncodeError: 'mbcs' codec can't encode
如果必须沿用旧项目中的 CodeFormatter 配置怎么办？
可临时降级兼容，但仅限离线、无协作场景：
- 锁定 Sublime Text 3.2.2（最后兼容
CodeFormatter的版本），禁用自动更新 - 在项目根目录放
.php_cs.dist文件，内容用PhpCsFixer\Config::create()->setRules(['@PSR2' => true])，避免插件读取全局配置出错 - Python 文件改用
autopep8替代（pip install autopep8），因为CodeFormatter对black的调用逻辑完全不可配置
真正麻烦的不是配置，而是当多人协作时，有人用 Sublime + CodeFormatter，有人用 VS Code + Prettier，同一份代码提交后 diff 全是空格和换行变化——这种格式差异比不格式化更伤人。
