gofmt是Go官方强制统一代码风格的不可配置工具，仅按硬编码规则重排代码：tab缩进、操作符空格、括号位置等均不可调；默认从标准输入读取，不加-w只输出不写入，-w才覆盖文件。
gofmt 不是用来统一团队风格的“配置工具”，它只做一件事：按 Go 官方硬编码规则重排代码。你改不了缩进是 tab 还是空格、调不了行宽、也不能让括号换行方式变个样——所有规则写死在 Go 源码里，不接受任何配置文件或开关。
为什么直接运行 gofmt 会卡住
这不是 bug，是设计使然：gofmt 默认从标准输入读代码，没输完就一直等。
- 终端敲
gofmt后光标不动？你在 stdin 等输入，按Ctrl+D（macOS/Linux）或Ctrl+Z回车（Windows）才能触发输出 - 想格式化文件但忘了写路径，
gofmt就卡在那儿，不报错也不退出 - 编辑器里配置了
gofmt却没反应，大概率是底层调用链被覆盖（比如实际走的是gopls或goimports），而不是gofmt本身失效
gofmt -w 是日常唯一需要记住的命令
不加 -w 只打印结果到终端，不会改文件——很多人误以为格式化成功了，其实啥都没保存。
-
gofmt -w main.go：格式化单个文件并写回 -
gofmt -w ./：格式化当前模块下所有.go文件（注意是./，不是.；缺go.mod会报no Go files in） -
gofmt -w *.go：只处理当前目录下的.go文件，不递归子目录 -
gofmt -d ./：预览差异（类似git diff），不写入，适合 CI 校验或提交前检查
go fmt 和 gofmt 到底用哪个
go fmt 是 gofmt -w 的封装，但行为更贴近 Go 包模型；gofmt 更底层、更“Unix”。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
-
go fmt ./：推荐用于整个模块，自动识别包边界，跳过_test.go里的ExampleXXX函数（这是有意为之） -
gofmt -w ./：只看文件后缀和路径，不管是不是合法 Go 包，适合清理临时目录或非模块项目 - 两者都不支持
-s（简化代码）以外的风格开关；-s能删掉s[a:len(s)] → s[a:]这类冗余，但默认关闭，需显式加参数 - CI 中建议用
go fmt -l ./检查是否全部格式化——有输出即表示存在未格式化文件，可作为 gate
编辑器里格式化失效的三个关键检查点
VS Code / GoLand 看似点了“格式化”，但背后可能根本没调用你认为的那个命令。
- 查
go.formatTool设置：必须是"goimports"或"gopls"，设成"gofmt"已属过时配置 - 确认
gopls可执行：运行go env GOPATH，再看$GOPATH/bin/gopls是否存在且有执行权限 - 留意
go.mod：没有模块定义时，goimports会静默失败，gopls可能降级为仅处理当前文件，不管理 import
真正麻烦的不是不会敲命令，而是以为 gofmt 能解决团队风格争论——它不能。最常被忽略的其实是 go.mod 是否存在、编辑器调用的是哪个二进制、以及 -w 是否真的被传下去了。
