Doom Emacs中解决TypeScript/NextJS项目保存时格式化的错误

在Doom Emacs中使用TypeScript/NextJS项目时，开发者可能会遇到一个常见的配置问题：当尝试保存文件时，模型线会显示错误信息"no such formatter defined in 'aphelia-formatters': :none"。这个问题通常是由于格式器配置不当引起的。

问题背景

Doom Emacs内置了强大的代码格式化功能，主要通过Apheleia模块实现。当开发者同时启用了其他格式化工具（如prettier-js）时，可能会产生配置冲突。错误信息表明系统找不到名为":none"的格式化程序，这通常是因为开发者试图通过设置"+format-with :none"来禁用内置格式化功能，但这不是正确的做法。

解决方案

有四种推荐的方法可以正确解决这个问题：

1. 使用禁用列表 将不需要内置格式化的模式添加到禁用列表中：

   (add-to-list '+format-on-save-disabled-modes 'rjsx-mode)
   (add-to-list '+format-on-save-disabled-modes 'js2-mode)
   

2. 使用抑制函数 通过钩子函数在特定条件下禁用Apheleia：

   (add-hook! 'apheleia-inhibit-functions 
     (bound-and-true-p prettier-js-mode))
   

3. 直接关闭Apheleia模式 在特定模式中完全禁用Apheleia：

   (add-hook! '(js2-mode-hook typescript-mode-hook rjsx-mode-hook) 
     (apheleia-mode -1))
   

4. 设置缓冲区局部变量 在特定缓冲区中抑制Apheleia：

   (setq-hook! '(js2-mode-hook typescript-mode-hook rjsx-mode-hook) 
     apheleia-inhibit t)
   

最佳实践建议

对于TypeScript/NextJS项目，推荐采用第二种方案（使用抑制函数），因为它可以智能地在prettier-js启用时自动禁用Apheleia，保持配置的灵活性。同时，确保prettier已经通过npm全局安装，并且在项目中配置了适当的.prettierrc文件。

如果项目需要更复杂的格式化策略，可以考虑创建自定义的Apheleia格式化程序，而不是完全禁用它。这样可以充分利用Doom Emacs的格式化基础设施，同时保持与其他工具的兼容性。

记住，在修改Emacs配置后，建议执行"doom sync"命令来确保所有更改正确加载。通过这些调整，开发者可以享受流畅的TypeScript/NextJS开发体验，而不会遇到格式化冲突问题。