go 1.16+默认启用模块，gopath已非必需；关键在于确保go111module=on、gobin或$gopath/bin加入path、go mod init正确初始化模块路径，并避免环境变量冲突。
Go 1.16 之后默认启用模块（GO111MODULE=on），本地库安装不再依赖 GOPATH，但很多人仍按老习惯配置，结果导致 go install 失败、go run 找不到命令、或 go get 下载到错误路径——核心问题不在“装没装”，而在“环境变量是否干扰了模块行为”。
go install 本地二进制不生效？检查 GOBIN 和 PATH
现代 Go（1.16+）用 go install path@version 安装可执行工具（如 dlv、gofumpt），它默认把二进制写入 $GOBIN；若未设置 GOBIN，则 fallback 到 $GOPATH/bin。但如果你只设置了 GOPATH 却没把 $GOPATH/bin 加进 PATH，终端就找不到命令。
- 运行
go env GOBIN看输出：为空？说明 Go 正在用默认路径，此时必须确保$GOPATH/bin在PATH中 - 更推荐显式设置：
export GOBIN=$HOME/go/bin，再加$GOBIN到PATH，避免歧义 -
go install golang.org/x/tools/cmd/gopls@latest成功后，立刻验证：which gopls应返回$GOBIN/gopls
go get 安装本地包失败？别碰 GOPATH/src
在模块模式下，go get 不再把代码存进 $GOPATH/src，而是下载到 $GOMODCACHE（通常是 $GOPATH/pkg/mod）。手动往 $GOPATH/src 放代码、再 go get ./localpkg 是无效的，Go 会报 no required module provides package。
- 本地开发库应放在项目目录内，比如
myapp/internal/utils，直接import "myapp/internal/utils" - 想临时替换远程依赖为本地路径？用
replace：在go.mod里写replace github.com/foo/bar => ./local-bar - 误删了
go.sum或缓存？用go mod download重新拉取，别手动复制文件
Linux/macOS 下 go install 报 permission denied？别用 sudo
常见错误是解压 Go 到 /usr/local/go 后，又试图用 sudo go install 写入 /usr/local/bin——这既不安全，也违背 Go 工具链设计原则。
-
go install默认写入用户可写的$GOBIN，不是系统级路径 - 如果硬要装到
/usr/local/bin，应改用go build -o /usr/local/bin/mytool .，并确保你有该目录写权限 - 更稳妥做法：始终用
$HOME/go/bin，它天然属于当前用户，且PATH优先级高于系统路径，避免冲突
Windows 上 go run 找不到本地模块？注意路径分隔符和模块初始化
Windows 用户常遇到 go run main.go 报 cannot find module providing package，尤其当项目在非 GOPATH 路径时。这不是权限问题，而是 Go 没识别出这是模块根目录。
- 进入项目目录后，先运行
go mod init example.com/myapp（名字随意，但必须执行） - 确保
go.mod文件存在且第一行是module example.com/myapp，不能是空文件或只有注释 - Windows 路径中反斜杠
\在 import 语句里会被忽略，但模块路径必须用正斜杠/，例如import "example.com/myapp/utils"，而非"example.com\myapp\utils"
最易被忽略的一点：go env -w 写死的环境变量（比如 go env -w GOPROXY=https://goproxy.cn）会覆盖 shell 配置文件里的设置，排查时先看 go env 输出，而不是只查 .zshrc ——很多“配置了却无效”的问题都出在这里。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
