go version报错或找不到命令说明path未生效或安装路径未被shell识别；windows需确认path含c:\go\bin，macos/linux需检查~/.zshrc等配置并source，which go无输出即path未生效。
go version 显示异常或找不到命令
说明：这不是“没装好”，而是 PATH 没生效，或安装路径未被 shell 正确识别。
实操建议：
- Windows 用户检查
Path环境变量是否包含C:\Go\bin（或自定义安装路径的\bin子目录），注意不要漏掉\bin - macOS/Linux 用户确认修改的是当前 shell 的配置文件：
~/.zshrc（macOS Catalina 及以后默认）、~/.bash_profile或~/.profile；改完必须运行source ~/.zshrc - 新开终端后执行
which go，若无输出，说明 PATH 未生效；若输出路径但go version报错，可能是二进制损坏，重装更稳妥
go mod init 后 go build 失败：import path not found
说明：模块初始化后，go build 默认按 module 路径解析 import，而非 GOPATH 下的相对路径。常见于老教程迁移项目。
实操建议：
- 检查
go.mod第一行的 module 名是否与代码中import语句匹配，例如module example.com/myapp对应import "example.com/myapp/utils" - 避免在
src/目录下手动建子目录再go mod init——这会导致 import 路径和物理路径错位；直接在项目根目录初始化即可 - 如果只是本地包，用相对 import 不安全，应统一使用 module 路径；若坚持用
./utils，需确保不在 module 模式下（GO111MODULE=off），但不推荐
交叉编译时 CGO_ENABLED 导致失败
说明：CGO_ENABLED=0 是静态编译关键开关，但默认开启；跨平台编译（如 macOS 编译 Linux 二进制）若含 cgo 依赖会报错或生成动态链接库。
实操建议：
- 纯 Go 项目（无
#include、无import "C"）务必加CGO_ENABLED=0，例如：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app-linux - 含 cgo 的项目（如调用 OpenSSL、SQLite）不能设为 0，需确保目标平台有对应 C 工具链（如
x86_64-linux-gnu-gcc），且CC环境变量指向它 -
go build -ldflags="-s -w"可进一步裁剪符号表和调试信息，减小体积，但不影响安全性
go install 安装第三方工具时权限或代理失败
说明：go install 自 Go 1.18 起默认要求模块路径带版本后缀（如 @latest），且受 GOPROXY 和 GOPRIVATE 控制。
实操建议：
- 国内用户必须配置代理，否则
go install github.com/google/gops@latest会卡住或超时：go env -w GOPROXY=https://goproxy.cn,direct - 公司私有仓库需同时设置：
go env -w GOPRIVATE=git.example.com/internal，否则代理会尝试转发导致 404 - 避免用
go get安装 CLI 工具（已废弃），一律用go install；若提示 “no required module provides package”，说明未在 module 根目录下执行，或未指定版本
go build 默认不校验 checksum，go mod download 也不强制验证。生产构建前应运行 go mod verify，并确保 go.sum 提交进 Git——否则无法保证依赖来源一致。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
