go version报“command not found”并非go未安装，而是path未包含$goroot/bin；windows安装.msi通常自动配置，linux/macos需手动确认goroot路径（如/usr/local/go），在~/.zshrc或~/.bashrc中添加export path=$path:$goroot/bin并source生效。
go version验证失败，PATH没配对
执行go version报command not found，不是Go没装好，而是PATH漏加了$GOROOT/bin。Windows用户装.msi包通常自动配置，但Linux/macOS手动解压后必须自己加：
- 确认
GOROOT路径（如/usr/local/go），用ls $GOROOT/bin看是否存在go可执行文件 - 在
~/.zshrc或~/.bashrc里追加：export PATH=$PATH:$GOROOT/bin - 别忘了
source ~/.zshrc重载，否则新开终端才生效 - 注意：macOS Catalina+默认用zsh，别往
.bash_profile里写
go build慢得反常，先跑go build -x
“编译慢”90%不是Go本身的问题，而是构建流程卡在非编译环节。加-x参数能暴露真实耗时点：
-
go list扫描整个模块树——尤其当go.mod里有replace或本地路径时，会递归遍历所有子目录 - 校验
sum.golang.org超时——国内直连常卡5–10秒，设GOPROXY=https://goproxy.cn,direct可绕过 -
go:generate无差别触发——改一行.go却重跑一遍protoc，建议只在.proto变更时触发 - 误用
-a或-i参数——Go 1.12+已废弃，强制全量重编，直接删掉
VS Code里Go插件总下载失败，代理和工具链要分清
VS Code的Go插件（vscode-go）启动时会自动下载dlv、gopls等工具，但这些下载走的是独立通道，不继承GOPROXY设置：
- 必须在VS Code设置里显式填入代理：搜索
go.toolsEnvVars，设为{"GOPROXY": "https://goproxy.cn,direct"} -
gopls版本要匹配Go版本——Go 1.22需用gopls v0.15+，旧版可能崩溃或无法索引 - 如果插件提示“failed to install”，别反复点击安装，先在终端手动运行：
GOBIN=$HOME/go/bin go install golang.org/x/tools/gopls@latest - Windows上防病毒软件可能拦截
dlv启动，临时禁用再试
路由注册写进main.go，每次改都全量重扫
把几十个HTTP handler硬编码在main.go里，表面方便，实际让go list每次都要扫描整个包树，拖慢构建速度：
- 拆出路由逻辑到独立
router/包，用函数返回echo.Group或gin.RouterGroup - 避免反射式自动注册（比如某些admin框架的
init()扫描）——它会触发额外类型分析 - 模板嵌入用
embed时，路径别写**/*.html，精确到./templates/*.html，减少文件系统遍历 - 调试模式如
echo.Debug = true会关闭部分编译优化，开发期开着没问题，CI构建前务必关掉
go build -x输出，比十次重装Go更有诊断价值。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
