VSCode原生不支持CoffeeScript格式化，需用coffee-fmt配合Run on Save扩展实现保存即格式化；因CoffeeScript无官方LSP、Prettier插件过时、ESLint无格式能力且内置JS/TS格式器不识别.coffee语法。
VSCode 原生不支持 CoffeeScript 格式化，必须靠外部工具链驱动；直接启用 editor.formatOnSave 会静默失效，不是配置漏了，而是根本没注册格式化器。
为什么 VSCode 默认无法格式化 .coffee 文件
CoffeeScript 没有官方 LSP 支持，VSCode 的“格式化文档”命令（Shift+Alt+F）在打开 .coffee 文件时找不到可用的 formatter，状态栏语言模式可能显示为 “CoffeeScript”，但背后没有绑定任何格式化逻辑。
- 即使装了 Prettier，它默认不支持
.coffee—— 需额外插件如prettier-plugin-coffeescript，但该插件长期未更新，对现代 CoffeeScript（如带可选链、空值合并）兼容性差 - ESLint 也不提供 CoffeeScript 格式能力，
eslint --fix对语法树结构无感，只做规则检查 - VSCode 的内置 JS/TS 格式化器完全不识别
.coffee语法，不会 fallback 或报错，只是“不响应”
用 coffee-fmt 实现保存即格式化的实操步骤
这是目前最稳定、最小侵入的方案，依赖命令行工具 + 扩展触发，绕过 VSCode 格式化 API 限制。
- 终端执行
npm install -g coffee-fmt（确保coffee-fmt -v能输出版本） - 安装 VSCode 扩展
Run on Save（id: emeraldwalk.runonsave） - 在
settings.json中添加如下配置：
"emeraldwalk.runonsave": {
"commands": [
{
"match": "\.coffee$",
"cmd": "coffee-fmt -i ${file}"
}
]
}
-
-i参数必须加，否则coffee-fmt默认输出到 stdout 而非覆盖文件 - 如果项目用了 nvm 或自定义 Node 版本，VSCode 可能找不到全局 bin，此时需在设置中指定完整路径，例如
/Users/xxx/.nvm/versions/node/v20.15.0/bin/coffee-fmt
常见失败现象和对应排查点
格式化没反应？大概率卡在这几个地方：
- 保存后无变化 → 检查
coffee-fmt -i path/to/file.coffee在终端是否真能成功运行；若报SyntaxError，说明文件本身有 CoffeeScript 语法错误，coffee-fmt拒绝处理 - 报错 “command not found” → 不是 npm 全局安装失败，而是 VSCode 启动时没读取 shell 的
$PATH，macOS 用户建议从命令行启动 VSCode：code . - 部分代码被格式化、部分被跳过 →
coffee-fmt对嵌套缩进、多行对象字面量等老式写法支持不稳定，避免混用空格与 tab，且不要在 class 定义里写裸 object literal
真正麻烦的不是配置，而是 CoffeeScript 本身缺乏活跃维护——coffee-fmt 最后一次发布是 2022 年，它不理解 ?.() 或 ?? 这类现代语法。如果你的项目已升级 CoffeeScript 2.x+，务必先验证一段含新特性的代码能否被 coffee-fmt 接受，否则自动格式化反而会引入错误。
