如何在typescript-tools.nvim中禁用自动格式化功能

typescript-tools.nvim作为一款TypeScript语言服务器插件，默认会提供代码格式化功能。但开发者有时需要禁用其内置的格式化功能，转而使用其他专用格式化工具（如conform.nvim或prettier_d配合null-ls）。本文将详细介绍配置方法。

核心配置方案

通过LSP客户端的on_attach回调函数，可以精确控制语言服务器提供的功能。以下是禁用格式化功能的标准配置：

require("typescript-tools").setup {
  on_attach = function(client)
    -- 禁用文档范围格式化
    client.server_capabilities.documentFormattingProvider = false
    -- 禁用选择范围格式化
    client.server_capabilities.documentRangeFormattingProvider = false
  end,
}

技术原理

1. LSP能力协商：Neovim的LSP客户端会与语言服务器协商可用的功能
2. 能力开关：通过设置documentFormattingProvider和documentRangeFormattingProvider为false，明确告知不使用服务器的格式化功能
3. 执行时机：on_attach回调确保在LSP连接建立后立即应用这些设置

典型应用场景

1. 专用格式化工具集成：当使用prettier、eslint等专用格式化工具时
2. 统一格式化策略：在项目中保持所有文件使用相同的格式化工具
3. 性能优化：减少语言服务器的功能负担

注意事项

1. 此配置仅禁用typescript-tools的格式化功能，不影响其他LSP功能
2. 需要确保已安装并配置了替代的格式化工具
3. 建议在配置后验证其他LSP功能（如代码补全、诊断等）是否正常工作

通过这种配置方式，开发者可以灵活组合不同工具的优势，构建最适合自己工作流的开发环境。