Go环境“可用”需满足：go mod init生成go.mod、GO111MODULE=on、import路径与模块名一致、GOPROXY配置正确；仅go version成功不代表依赖管理就绪，常见报错“cannot find module”多因未初始化模块或路径不匹配。
go run 成功但 go build 报错、依赖拉不下来、模块初始化混乱，根源不在语法，而在环境配置和概念理解偏差。
go version 能输出，不代表 GOPATH 和 Go Modules 已就绪
安装完 Go 后执行 go version 只验证了 SDK 本身，但 Go 的项目行为由两个关键机制共同决定：GOPATH（旧模式）和 go.mod（新模式）。现在默认启用 Go Modules，但如果你没显式初始化，Go 仍可能退回到 GOPATH 模式，导致依赖下载到 $GOPATH/pkg/mod 却不被当前项目识别。
- 新项目必须在项目根目录执行
go mod init example.com/myapp，生成go.mod文件，否则所有import都会触发 “no required module provides package” 错误 -
go env GOPATH查出的路径只是缓存位置（如$HOME/go），它不再约束项目存放位置；项目可放在桌面、/tmp或任意目录 - 若你看到
cannot find module providing package，大概率是忘了go mod init，而不是网络或路径问题
国内拉包失败，别急着换镜像源，先看 go env -w
直接改 ~/.bashrc 或 profile 里加 export GOPROXY=... 是过时做法。Go 1.13+ 支持用 go env -w 写入配置，且优先级高于环境变量，更可靠。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐清华、中科大或 goproxy.cn） - 再执行
go env GOPROXY确认输出是否匹配，避免拼写错误（比如写成GO_PROXY就无效） - 如果仍超时，检查是否漏了
direct—— 它表示对私有模块（如公司内网 Git）跳过代理，否则私有包会 404 - 临时关闭代理调试：
go env -w GOPROXY=direct
main.go 能跑，但 import 第三方包报错，问题常出在路径和大小写
Go 对 import 路径极其严格：它不是文件系统路径，而是模块路径（module path），且区分大小写。常见错误不是“找不到包”，而是“路径不匹配”。
-
import "github.com/gin-gonic/gin"要求你的go.mod中模块名不能是example.com/myapp吗？不，没关系——但你执行go get github.com/gin-gonic/gin时，Go 会把该包下载到本地缓存，并记录版本到go.mod；如果手动删了go.sum又不重新go get，就会提示校验失败 - Windows 用户尤其注意：路径中含空格或中文（如
C:\Users\张三\go\src\...）会导致某些工具链解析失败，建议项目路径全英文、无空格 - VS Code 提示 “no packages found”？先在终端进项目目录，运行
go list ./...，如果报错，说明go.mod损坏或未初始化，IDE 的 Go 插件无法自动修复这点
go run 和 go build 行为不同，别用前者掩盖构建问题
go run main.go 是临时编译并执行，不生成可执行文件；go build 才真正模拟部署流程。很多“本地能跑线上炸”的问题，源于只测了前者。
立即学习“go语言免费学习笔记（深入）”；
-
go run会忽略build tags（如// +build !windows），而go build会严格检查，跨平台项目务必用go build验证 -
go build -o myapp生成的二进制默认静态链接，不含外部动态库依赖——这是 Go 部署优势，但若用了 cgo（如调用 C 库），需加-ldflags '-extldflags "-static"'才真正免依赖 - 想快速验证是否真能部署？在干净目录下
git clone项目，然后go mod download+go build，跳过go run
mkdir demo && cd demo && go mod init demo && go get github.com/valyala/fastjson && echo 'package main; import _ "github.com/valyala/fastjson"; func main(){}' > main.go && go build 这一串命令能一次性成功。中间任何一步卡住，都不是代码问题，而是环境或概念没理清。 
