先检查path是否生效：macos/linux运行which go，windows用get-command go；未输出则需将go的bin路径加入shell配置并source或重启终端；再确认go111module=on、清理vendor/、避免在gopath/src下初始化。

go version 报 command not found 怎么办

根本不是没装好，是 PATH 没生效。别急着重装。

• macOS/Linux：运行 which go，没输出就说明 shell 没读到 go 所在路径；检查安装位置（比如 /usr/local/go/bin）是否已加进 ~/.zshrc 或 ~/.bash_profile 的 PATH 里
• Windows：用 PowerShell 运行 Get-Command go，失败就去「系统属性 → 高级 → 环境变量」确认 C:\Program Files\Go\bin（或你自定义的 GOROOT/bin）进了用户或系统 PATH
• 改完配置必须 source ~/.zshrc（或重启终端），安装器勾选的“添加到 PATH”不会自动刷新当前终端

go mod init 失败或生成错误的 go.mod

常见于旧项目迁移，不是命令写错，而是环境残留干扰。

Alibabacloud Sdk Client Initialization For Golang

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

• 先运行 go env -w GO111MODULE=on，强制启用模块模式（Go 1.21+ 默认开启，但 CI 脚本或老终端可能关着）
• 删掉项目根目录下的 vendor/（除非你明确要用 vendor 机制）
• 检查当前目录是否在 $GOPATH/src 下——如果是，go mod init 会按旧 GOPATH 规则推导 module 名，大概率出错；建议 cd 到任意非 $GOPATH 路径下再初始化

VS Code 里 gopls 启动失败

gopls 是语言服务器，不是插件装上就跑得起来。

• 必须确保 go 命令全局可用（go version 能执行）
• 项目根目录要有 go.mod（或至少能被 go mod init 正确生成）
• .go 文件后缀要对，且不能放在 vendor/ 或 testdata/ 这类被 Go 工具忽略的目录里

统信UOS / Linux 手动解压后 go 命令仍不可用

手动解压方式最易卡在环境变量配置环节，尤其多用户或免 root 场景。

• 如果用 sudo tar -C /usr/local -xzf go*.tar.gz，记得补上 export GOROOT=/usr/local/go 和 export PATH=$PATH:$GOROOT/bin；GOPATH 可不设，模块模式下它只影响 go install 输出位置
• 普通用户免 root 安装：解压到 $HOME/local/go，然后在 ~/.zshrc 里写 export GOROOT=$HOME/local/go 和 export PATH=$PATH:$GOROOT/bin
• APT 安装（如 apt install golang）虽快，但版本常滞后；验证时除了 go version，务必跑 go mod init test && go build 看模块功能是否真通

真正容易被忽略的是：模块模式启用状态、vendor/ 目录残留、以及当前 shell 是否真的加载了最新 PATH —— 这三者叠加，会让 go 命令看似正常，却在 mod init 或 gopls 阶段静默失败。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！