CodeFormatter 插件已不推荐使用——自2018年停更，不兼容Sublime Text 4及现代语法，强行安装易报错或失效；应改用Build System调用prettier、black、php-cs-fixer 3.x等现代CLI工具。

CodeFormatter 插件在当前（2026年7月）已不推荐安装或启用——它自 2018 年起停止维护，与 Sublime Text 4 及现代语言语法严重不兼容，强行安装大概率报错或静默失效。

---

CodeFormatter 安装后为什么按 Ctrl+Alt+F 没反应？

• 插件本身不再适配 Sublime Text 4 的 Python 3.8 运行时，中文路径下会抛出 UnicodeEncodeError: 'mbcs' codec can't encode
• 即使侥幸安装成功，底层依赖的 js-beautify、php-cs-fixer 1.x、PythonTidy 均已废弃，无法解析 async/await、PHP 8.0 属性类型、Python 3.12 模式匹配等语法
• Preferences > Package Settings > CodeFormatter > Settings - User 中配置的路径字段（如 php_cs_fixer_path）不支持多路径 fallback，Windows/macOS/Linux 下实际路径差异会导致命令找不到

---

替代方案：用 Build System 调用权威 CLI 工具

Sublime Text 本身不内置格式化能力，但可通过 Build System 稳定调用本地已安装的现代 formatter：

• JavaScript/TypeScript：用 prettier（需 npm install -g prettier）
• Python：用 black（需 pip install black，建议加 --line-length 88）
• PHP：用 php-cs-fixer 3.x（非 CodeFormatter 内置的 1.x），命令为 php-cs-fixer fix $file --rules=@PSR12
• C/C++/Java：用 astyle（需系统级安装，路径填入 AstyleFormatter 设置）

关键点：

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

• Build System 配置中必须包含 "selector": "source.js, source.ts, source.python, source.php"，否则右键无 “Build” 选项
• 所有 CLI 工具需确保能在终端中直接执行（即 prettier --version、black --version 等能返回结果）
• 不要用插件封装层，直接写 shell 命令更可控；比如 Python 的 Build System 内容可简写为：

  {
    "cmd": ["black", "$file"],
    "selector": "source.python",
    "working_dir": "$file_path"
  }
  

---

如果你正在维护老项目且必须沿用 CodeFormatter

仅限离线、单机、无协作场景下临时降级使用：

• 锁定 Sublime Text 版本为 3.2.2（最后兼容版本），关闭自动更新
• 手动下载旧版 CodeFormatter ZIP 包（非 Package Control 安装），解压到 Packages/CodeFormatter
• 删除插件目录中所有 .pyc 文件，避免 Python 运行时冲突
• 配置文件里禁用所有非必需语言引擎，只保留 PHP 或 HTML 等简单场景

真实情况是：哪怕只处理一个带装饰器的 Python 类，CodeFormatter 仍可能把 @dataclass 后的缩进全打乱——这不是配置问题，是底层逻辑已失效。