go install 命令找不到是因为 path 未配置或 go 未真正安装生效；which go 返回空说明 shell 未加载 go 命令，需确认安装路径、修改对应 shell 配置文件（如 macos zsh 改 ~/.zshrc）、执行 source 生效，并验证 go version。
go install 为什么找不到命令
不是 PATH 没配对，而是你可能根本没装 Go —— 很多人从第三方镜像站或压缩包解压后直接扔进 /usr/local/go，但没执行 source ~/.bashrc 或重启终端，导致 go 命令压根不在 shell 环境里。
- 验证是否真装上了：
which go返回空就说明没生效 - Mac 用户用 zsh 的注意：改的是
~/.zshrc，不是~/.bash_profile - Windows 用户别用 PowerShell 默认配置，推荐在 VS Code 终端里用 Git Bash，避免
GOBIN和GOPATH路径解析出错
devcontainer.json 里 image 和 dockerfile 别混用
VS Code Remote-Containers 启动失败，90% 是因为 devcontainer.json 里同时写了 "image" 和 "dockerFile" 字段。这两者互斥，选一个就行 —— image 表示拉取现成镜像，dockerFile 表示本地构建，冲突时 VS Code 会静默忽略后者。
- 想用定制镜像？删掉
"image"，只留"dockerFile": "Dockerfile.dev" - 想快速启动？用官方基础镜像，比如
"mcr.microsoft.com/vscode/devcontainers/go:1.21"，别手写 Ubuntu + 手动装 Go - 注意路径：Dockerfile 必须放在项目根目录或
.devcontainer/下，否则 build 会报No such file or directory
gRPC 连接报 x509: certificate relies on legacy Common Name
Go 1.15+ 默认禁用了 CN（Common Name）字段校验，但很多旧脚本生成的证书还只填了 CN、没配 SAN（Subject Alternative Name），一连 gRPC 就崩： rpc error: code = Unavailable desc = connection error: desc = "transport: authentication handshake failed: x509: certificate relies on legacy Common Name"。
- 临时绕过（仅开发）：
GODEBUG=x509ignorecn=0 go run main.go - 正确做法：重生成证书，用
openssl时加-addext "subjectAltName = DNS:localhost,IP:127.0.0.1" - 别信网上一键脚本 —— 很多漏了
req_extensions配置，导致 SAN 不生效
GOROOT 和 GOPATH 到底要不要手动设
Go 1.16+ 已默认启用 module 模式，GOROOT 通常不用动（除非你装了多个 Go 版本），而 GOPATH 在绝大多数场景下也不必显式设置 —— VS Code 插件、go mod、甚至 go test 都能自动识别模块根目录下的 go.mod。
- 唯一要设
GOPATH的情况：你还在用go get安装老式工具（比如gopls旧版本），且没加-d参数 - 如果
go env GOPATH输出是空，别慌，这是正常行为；只要go list -m能列出当前模块，就说明 module 模式已就位 - VS Code 的 Go 扩展若提示 “No workspace detected”，八成是没在含
go.mod的目录里打开项目，而不是 GOPATH 没配好
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
