go 1.16之前不支持go.mod中replace本地路径，报“unknown directive: replace”是因goversion过低；需确认go version、goroot路径及模块根目录是否匹配。
Go版本冲突导致go mod报错unknown directive: replace
这个错误通常不是因为你写错了replace，而是当前GOVERSION太低——Go 1.16之前不支持在go.mod里直接用replace指向本地路径（比如replace example.com/foo => ./foo）。你执行go version看到的是go version go1.15.15 darwin/amd64，但项目go.mod第一行写着go 1.18，Go工具链会按最低兼容版本解析，结果就跳过或误读replace。
- 运行
go env GOROOT确认实际生效的Go安装路径，别只信which go - 检查
~/.bash_profile或~/.zshrc里有没有重复的export PATH=.../go/bin:$PATH，多个Go bin目录混在一起极易触发版本错配 - 临时验证：在项目根目录下运行
GOROOT=/usr/local/go1.18.10 /usr/local/go1.18.10/bin/go mod tidy，绕过环境变量直调指定版本
GO111MODULE=on但go get仍走$GOPATH
这不是模块开关没开，而是当前目录不在模块根下——Go判断是否启用module，优先看有没有go.mod文件，其次才看GO111MODULE。你在~/workspace/myapp/cmd/server里执行go get github.com/gin-gonic/gin，但go.mod其实在~/workspace/myapp，这时Go会退回到GOPATH模式，把包下到$GOPATH/src/github.com/gin-gonic/gin，而不是写进go.mod。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 执行
go list -m，如果报错not in a module，说明当前工作目录没被任何go.mod覆盖 - 用
git rev-parse --show-toplevel快速定位仓库根，然后cd进去再操作 - 别依赖
GO111MODULE=auto，它只在有go.mod或vendor目录时才开，纯新目录默认关
Mac M1芯片上CGO_ENABLED=1编译失败，提示ld: library not found for -lcrypto
这是OpenSSL头文件和库路径没对上，不是缺少包。Homebrew装的OpenSSL 3默认装在/opt/homebrew/opt/openssl@3，但Go的cgo默认只查/usr/lib和/usr/local/lib，找不到libcrypto.dylib就跪。
- 先运行
brew --prefix openssl@3拿到真实路径，比如输出/opt/homebrew/opt/openssl@3 - 编译前加环境变量：
CGO_CPPFLAGS="-I/opt/homebrew/opt/openssl@3/include" CGO_LDFLAGS="-L/opt/homebrew/opt/openssl@3/lib" go build - 如果用
go install或CI构建，把这两行写进.zshrc并source，别只在当前shell临时设
VS Code里gopls一直显示“Loading…”或跳转失效
根本原因往往是gopls启动时读取了错误的Go版本或模块配置。它不读shell里的PATH，而是读VS Code启动时继承的环境变量——从Dock或Spotlight点开的VS Code，PATH里可能根本没有/usr/local/go/bin。
- 终端里运行
code --version，再运行which gopls，对比两者路径是否一致；不一致就说明VS Code没加载你的shell配置 - 在VS Code里按
Cmd+Shift+P→ 输入Developer: Toggle Developer Tools→ Console里搜gopls，看报错里写的GOROOT是不是旧路径 - 最稳解法：删掉
~/Library/Application Support/Code/User/globalStorage/golang.go-nightly缓存，重启VS Code，让它重新下载匹配当前Go版本的gopls
GOROOT、GOPATH、当前目录的模块归属，以及它们之间有没有隐式覆盖。环境变量和文件系统路径的微小错位，在Go这种强约定工具链里，会直接变成“命令能跑但行为不对”的疑难杂症。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
