Golang官方提供的gofmt工具是专门用于格式化Go语言代码的工具，它会按照官方定义的代码风格规范自动调整代码的缩进、换行、空格等格式，不需要开发者手动调整，是Go项目开发中必备的工具之一。
gofmt工具基础介绍
gofmt是Go语言安装包自带的内置工具，只要正确安装了Go环境，就可以直接在命令行中使用。它的核心作用是读取Go源文件，按照统一的格式重新输出代码内容，默认会直接修改原文件。
查看gofmt版本
可以通过以下命令确认gofmt是否可用以及查看相关信息：
# 查看gofmt版本信息 gofmt -version
gofmt常用参数说明
gofmt支持多个参数来调整格式化行为，以下是常用的参数列表：
| 参数 | 作用说明 |
|---|---|
| -w | 将格式化后的结果直接写回原文件，不添加该参数则只会将结果输出到控制台 |
| -l | 只列出需要格式化的文件名称，不会实际执行格式化操作 |
| -d | 显示格式化前后的差异内容，不会修改原文件 |
| -s | 简化代码，比如将数组、切片的初始化写法简化 |
手动使用gofmt格式化代码
在没有配置自动格式化的场景下，可以手动执行gofmt命令来格式化代码：
格式化单个文件
如果要格式化当前目录下的main.go文件，并且将结果写回原文件，可以执行以下命令：
# 格式化单个Go文件并覆盖原文件 gofmt -w main.go
格式化整个目录
如果要格式化某个目录下的所有Go文件，可以指定目录路径，命令如下：
# 格式化src目录下的所有Go文件 gofmt -w ./src
查看格式化差异
如果想先查看代码格式化的改动内容，再决定是否执行格式化，可以使用-d参数：
# 查看main.go的格式化差异 gofmt -d main.go
配置Golang自动格式化代码
手动执行命令效率较低，开发者通常会配置开发工具，在保存文件时自动执行gofmt格式化，以下是常见场景的配置方法。
VS Code配置自动格式化
VS Code是Go开发常用的编辑器，配置步骤如下：
- 安装官方Go插件，插件ID为
golang.go - 打开VS Code设置，搜索
editor.formatOnSave，勾选该选项，开启保存时自动格式化 - 搜索
go.formatTool，将值设置为gofmt，指定格式化工具为gofmt
配置完成后，每次保存Go文件时，VS Code会自动调用gofmt对当前文件进行格式化。
GoLand配置自动格式化
GoLand是JetBrains推出的Go专用IDE，配置步骤如下：
- 打开设置页面，进入
Tools->Actions on Save - 勾选
Reformat code选项，在下方的File types中确保包含Go文件类型 - 进入
Editor->Code Style->Go，确认代码风格为官方默认风格即可
Git提交前自动格式化
为了保证团队提交到仓库的代码都是格式化后的，可以配置Git钩子，在提交前自动执行gofmt。首先在项目根目录创建.git/hooks/pre-commit文件，内容如下：
#!/bin/bash
# 获取所有待提交的Go文件
files=$(git diff --cached --name-only --diff-filter=ACM | grep '.go$')
if [ -n "$files" ]; then
# 对每个文件执行gofmt格式化
echo "$files" | while read -r file; do
gofmt -w "$file"
git add "$file"
done
fi
然后给该文件添加执行权限：
chmod +x .git/hooks/pre-commit
配置完成后，每次执行git commit时，会自动格式化所有待提交的Go文件，并重新加入暂存区。
gofmt使用注意事项
- gofmt的格式化规则是Go官方固定的，不支持自定义格式规则，这也是Go语言统一代码风格的设计理念
- 执行
gofmt -w前建议先提交代码到版本库，避免格式化后出现不可预期的问题无法回滚 - 如果项目中使用了
goimports工具，也可以用goimports替代gofmt，它会在格式化的同时自动管理import语句
gofmt的设计目标是消除Go代码中不必要的格式差异，让开发者不需要在代码格式上花费额外精力，专注于业务逻辑实现。