先看 go version 能否输出版本号，若失败则检查 PATH 是否包含 Go 的 bin 目录（macOS/Linux 为 /usr/local/go/bin，Windows 为 C:\Go\bin），并确认终端已重启或 source 配置文件。
go 命令装没装好，先看 go version 能不能跑出来
很多人卡在“明明双击安装包了，go fmt 却报 command not found”。这不是 Go 没装，是终端找不到它。
- macOS/Linux：执行
which go，没输出就说明 PATH 没生效；检查/usr/local/go/bin（或你自定义的安装路径）是否加进了~/.zshrc或~/.bash_profile，然后source ~/.zshrc - Windows：用 PowerShell 运行
Get-Command go；如果失败，去「系统属性 → 高级 → 环境变量」里确认Go\bin目录进了 PATH（别信安装器勾选的“自动添加”，重启终端才生效） - 验证成功后，
go version应返回类似go version go1.22.5 darwin/arm64的结果——这是后续所有工具的基础
格式化该用 go fmt 还是 goimports？别只看名字
go fmt 只动结构：缩进、括号换行、操作符空格。它不管 import，也不会删掉你写的 import "fmt" 后面那行没用的 import "os"。
- 日常开发强烈推荐
goimports：它兼容go fmt全部能力，额外自动增删 import、按标准库/第三方/本地分组排序 - 安装命令必须用
go install golang.org/x/tools/cmd/goimports@latest（Go 1.21+ 要求），不是go get - 装完验证：
goimports -v应输出版本；再确认$GOBIN或$GOPATH/bin在 PATH 里（echo $PATH看一眼） - CI 中检查用
goimports -l ./：有未格式化文件时会输出路径并返回非零码，适合阻断 PR
VS Code 里保存就格式化，关键就三件事
VS Code 不是装了 Go 插件就自动干活，得手动点几处开关。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 装官方插件：
golang.go（ID 是golang.go，别装错成社区旧版） - 设置里搜
go.formatTool，值设为"goimports"（不是"gofmt"，也不是空字符串） - 确保
"editor.formatOnSave": true开启（全局或当前工作区） - 右下角状态栏点 “Go” 图标，如果显示 “Formatting with goimports”，说明链路通了；如果灰掉或报错，大概率是
goimports路径不对或权限问题
.editorconfig 对 Go 文件基本没用，别白配
Go 的缩进、换行、空行全由 goimports 或 gofumpt 强制决定，.editorconfig 里写的 indent_size = 4 或 tab_width = 4 完全不生效。
立即学习“go语言免费学习笔记（深入）”；
- 唯一有用的是告诉编辑器：“这是 Go 文件”，避免它拿 JS 规则来格式化
.go文件 - 真要留，就写最简配置：
[*.go]<br>end_of_line = lf<br>insert_final_newline = true
- 别碰
indent_style和indent_size——Go 格式器只认 tab 缩进，且 tab 显示为几个空格由编辑器渲染决定，跟配置无关
goimports -w ./ 和 VS Code 保存触发的格式化，背后调用的可能是不同二进制（比如 VS Code 用的是 gopls 内置的 goimports，而 CLI 调的是 PATH 里的），版本不一致时 diff 会不一样。统一用 go install 安装，并在 IDE 设置里显式指定工具路径，比靠默认更稳。 
