如何在Neovim中配置Git Commit文件类型插件以设置textwidth=72？

1. 确认文件路径与命名正确性 #

• 确保gitcommit.lua放在正确的ftplugin目录：
  • Linux/macOS：~/.config/nvim/ftplugin/gitcommit.lua
  • Windows：%USERPROFILE%\AppData\Local\nvim\ftplugin\gitcommit.lua
• 文件名必须严格为gitcommit.lua（小写、无下划线），Neovim通过文件名匹配对应文件类型。

2. 检查插件内容的正确性 #

在gitcommit.lua中必须使用局部缓冲区设置而非全局设置，正确代码如下：

-- 仅对当前gitcommit缓冲区设置textwidth
vim.opt_local.textwidth = 72
-- 可选：优化注释行格式（适配Git Commit的注释区域）
vim.opt_local.commentstring = "# %s"
vim.opt_local.formatoptions:append("tc")

注：使用opt_local而非全局的vim.opt，确保设置仅作用于gitcommit类型文件，避免影响其他缓冲区。

3. 验证文件类型检测是否正常 #

打开Git Commit编辑界面后，执行以下命令确认文件类型：

:set filetype?

如果输出不是filetype=gitcommit，需在init.lua中开启文件类型检测：

vim.cmd("filetype plugin indent on")

该命令会启用文件类型检测、插件加载与自动缩进功能。

4. 排查缓存与配置覆盖问题 #

• 重启Neovim，避免插件缓存导致的加载异常；
• 手动加载插件测试是否生效：

  :source ~/.config/nvim/ftplugin/gitcommit.lua
  

• 检查是否有其他配置覆盖textwidth，在Commit界面执行：

  :verbose set textwidth?
  

  输出的最后一行会显示哪个文件最后修改了textwidth，据此排查冲突配置。

5. 备选方案：通过自动命令设置 #

如果ftplugin方式仍不生效，可直接在init.lua中添加自动命令：

vim.api.nvim_create_autocmd("FileType", {
  pattern = "gitcommit",
  callback = function()
    vim.opt_local.textwidth = 72
  end,
})

内容的提问来源于stack exchange，提问作者Sasgorilla