本文详细讲解如何在基于 vim-plug 的 Vim Go 开发环境中彻底禁用 gofmt 自动格式化，避免其覆盖自定义缩进（如 tabstop=4）和代码结构，并提供安全、可维护的配置方案。
本文详细讲解如何在基于 vim-plug 的 vim go 开发环境中彻底禁用 gofmt 自动格式化，避免其覆盖自定义缩进（如 `tabstop=4`）和代码结构，并提供安全、可维护的配置方案。
在使用 vim-plug 搭建 Go 开发环境时，许多开发者（尤其是习惯手动排版或需保留特定注释/空行结构的团队）会遇到 gofmt 强制重写代码的问题：它不仅自动插入换行、调整括号位置，还会将缩进统一为 8 个空格等效宽度（即 tabstop=8），与用户在 .vimrc 中设置的 tabstop=4 冲突，导致视觉错乱和协作困扰。
需要明确的是：gofmt 本身是 Vim 插件 vim-go 提供的默认格式化后端，并非 vim-plug 的功能。因此，禁用操作必须在 vim-go 配置层面完成。
✅ 正确禁用 gofmt 的完整配置
仅设置 g:go_fmt_autosave = 0 和 g:go_fmt_fail_silently = 1 并不能真正禁用 gofmt —— 它仍可能在执行 :GoFmt 命令、保存触发的钩子（如 autocmd BufWritePre）或 LSP 格式化中被调用。要彻底禁用，请在 .vimrc 中添加以下配置：
" 禁用 gofmt 自动格式化（含保存时、命令调用、LSP 格式化）
let g:go_fmt_autosave = 0
let g:go_fmt_command = 'none' " 关键！设为 'none' 可阻止 vim-go 调用任何格式化器
let g:go_imports_autosave = 0 " 同时禁用 goimports（避免其隐式触发格式化）
" 可选：禁用 LSP 层级的格式化（如使用 gopls）
if has('nvim')
lua << EOF
require'lspconfig'.gopls.setup{
settings = {
gopls = {
formatOnSave = false,
usePlaceholders = true,
}
}
}
EOF
else
" 对于 Vim 7.4，确保未启用 gopls 的 format_on_save（需确认是否已配置）
endif⚠️ 注意：g:go_fmt_command = 'none' 是核心配置项。它告诉 vim-go “不使用任何格式化命令”，从而绕过 gofmt、goimports 或 gofumpt 的所有调用路径，比单纯关闭 autosave 更彻底。
? 验证是否生效
编辑一个 .go 文件后，执行以下命令检查：
:echo g:go_fmt_command " 应输出 'none' :GoFmt " 应提示 "no formatter found" 或无任何变化（而非报错或重排代码）
同时，手动保存文件（:w）不应引发任何格式变动 —— 你的 set tabstop=4 shiftwidth=4 softtabstop=4 expandtab 将完全生效，头部注释块、逻辑分隔空行等人工排版将被完整保留。
? 补充说明：关于“8空格缩进”的常见误解
原问题中提到 “gofmt 添加 8-space tab”，这其实是一个视觉误解：gofmt 只使用制表符（\t）或空格，但从不硬编码‘8个空格’；它输出的缩进由 Go 语言规范决定（通常为 1 个 tab），而 Vim 显示为多宽，取决于 tabstop 设置。若你看到缩进变宽，是因为 tabstop 默认为 8 —— 此时只需确保 .vimrc 中包含：
autocmd FileType go setlocal tabstop=4 shiftwidth=4 softtabstop=4 expandtab
✅ 这样，即使 gofmt 输出 \t，Vim 也会将其显示为 4 列宽，与你的编码习惯一致。
? 总结建议
- 优先禁用而非对抗：g:go_fmt_command = 'none' 是最干净、最兼容 Vim 7.4 的禁用方式；
- 避免全局修改 Go 生态惯例：若团队协作，建议通过 gofumpt -extra 或自定义 .golangci.yml 实现风格统一，而非完全禁用；
- CentOS 7.2 + Vim 7.4 兼容性：上述配置无需 Lua 支持，纯 Vimscript，完美适配旧版环境。
至此，你已获得对 Go 代码格式化的完全控制权 —— 编码风格由你定义，工具为你服务，而非反之。
