gofmt 默认从标准输入读取代码，不加参数直接运行会卡住等待输入；它仅按go官方约定格式化代码，不支持个性化配置，-w标志才写入文件。
gofmt 不是用来统一风格的“配置工具”，它只做一件事：按 Go 官方约定重排代码。你改不了缩进是 4 还是 8，也加不了空行或调整括号位置——它不接受任何个性化设置。
为什么直接运行 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 -r做重构——规则难验证、无回滚、容易破坏语义，真要批量改用go fix或专用 refactoring 工具
go fmt 和 gofmt 到底用哪个
go fmt 是 gofmt -w 的封装，但行为更贴近 Go 包模型；gofmt 更底层、更“Unix”。
-
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 是否在根目录、以及你写的那行 gofmt -w 有没有漏掉 -w。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
