gofmt只按Go官方约定重排代码，不支持任何个性化配置；它默认从标准输入读取代码，未提供输入时会卡住等待Ctrl+D或Ctrl+Z触发，格式化文件需加-w参数。
gofmt 不是用来选风格的，它只做一件事：按 Go 官方约定重排代码。你改不了缩进宽度、空行数量、括号位置——它不接受任何个性化配置。
为什么 gofmt 命令一敲就卡住？
这不是 bug，是设计使然：gofmt 默认从标准输入读代码，没输完就一直等。终端敲 gofmt 后光标不动？你在 stdin 等输入，按 Ctrl+D（macOS/Linux）或 Ctrl+Z 回车（Windows）才能触发输出。
- 想格式化文件但忘了写路径，
gofmt就卡在那儿，不报错也不退出 - 直接运行
gofmt main.go只打印结果到终端，文件本身完全没变 - 真正要写回文件，必须加
-w：比如gofmt -w main.go
gofmt -w ./ 和 go fmt . 有什么区别？
两者都常用，但行为逻辑不同：
-
gofmt -w ./是底层路径扫描：只看.go文件后缀和当前目录结构，不管是不是合法 Go 包；缺go.mod会报no Go files in -
go fmt .是包模型驱动：自动识别包边界，跳过_test.go中的ExampleXXX函数（这是有意设计，不是 bug） - CI 中推荐用
go fmt -l ./检查：有输出即表示存在未格式化文件，可作为提交门禁
VS Code 里保存没反应，该查什么？
编辑器看似点了“格式化”，但背后可能根本没调用你认为的那个命令。关键检查点：
立即学习“go语言免费学习笔记（深入）”；
- 确认
go.formatTool设置的是gopls或goimports，设成gofmt已属过时配置 - 运行
go env GOPATH，再看$GOPATH/bin/gopls是否存在且有执行权限 - 没有
go.mod时，goimports会静默失败，gopls可能降级为仅处理当前文件
goimports 和 gofmt 能一起用吗？
不能混着用。goimports 是 gofmt 的超集：它会格式化 + 自动增删 import。两者直接混用会导致 import 被反复添加又删除，尤其在团队协作中容易引发无意义的 diff。
- 装
goimports：运行go install golang.org/x/tools/cmd/goimports@latest - VS Code 中把
go.formatTool设为goimports，重启编辑器 - 注意：
goimports要求项目含go.mod；Go 1.21 之前的旧结构（无go.mod）会静默失败
真正卡住人的从来不是不会敲命令，而是搞不清编辑器底层调用的是哪个工具、有没有真正执行、以及 go.mod 是否在根目录。
