go version报“不是内部或外部命令”是PATH未生效所致；Windows需勾选安装器“Add Go toPATH”或手动添加C:\Go\bin到系统环境变量，再新建终端验证where go，macOS/Linux同理配置PATH并source后验证which go。

go version 验证失败，PATH 没生效？

安装完 go 后执行 go version 报“不是内部或外部命令”，说明系统没找到 go 可执行文件。这不是安装失败，而是环境变量没加载进当前终端。

• Windows 用户：安装 .msi 时务必勾选 “Add Go to PATH”（新版安装器默认勾选，但老版本或手动解压安装可能没开）；若已安装，重启命令提示符或 PowerShell —— 不是关掉再打开，而是**新建一个窗口**
• 检查 go 是否真在路径里：运行 where go（Windows）或 which go（macOS/Linux），应返回类似 C:\Go\bin\go.exe 或 /usr/local/go/bin/go
• 如果 where go 无输出，手动把 C:\Go\bin（Windows）或 /usr/local/go/bin（macOS/Linux）加到系统 PATH 环境变量中，再新开终端

VS Code 里写 Go 代码没补全、跳转报错？

这不是插件装了就完事的问题——gopls 这个语言服务器没起来，VS Code 就只是个高级记事本。

• 先确认 gopls 已安装：终端运行 gopls version，有输出即正常；若报 command not found，执行 go install golang.org/x/tools/gopls@latest
• VS Code 中按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Go: Install/Update Tools，全选后回车 —— 注意：它会调用 go install，所以必须确保代理已配好（见下一条）
• 如果卡在某个工具（如 dlv 或 gotests）下载不动，别硬等，先配好代理再重试

GOPROXY 没设，go get 或 go mod tidy 直接卡死

国内不配代理，go 工具链几乎无法正常使用，这不是网络波动，而是模块代理域名被阻断的常态。

Alibabacloud Sdk Client Initialization For Golang

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

下载

• 执行这两条命令（Windows PowerShell / macOS/Linux 终端均可）：
  go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=off
• direct 表示对私有模块或未缓存模块直连，GOSUMDB=off 是为绕过校验服务器（国内访问常超时）
• 验证是否生效：新建空目录，运行 go mod init test → go get github.com/stretchr/testify，几秒内完成即成功
• 别用 https://proxy.golang.org，它在国内基本不可用；https://goproxy.cn 和 https://mirrors.aliyun.com/goproxy/ 更稳

go mod init 后 import 提示 “no required module provides package”

这是模块路径和实际 import 路径不一致导致的，常见于复制粘贴旧项目或手动改了 go.mod 的 module 名。

立即学习“go语言免费学习笔记（深入）”；

• 检查 go.mod 第一行 module 声明，比如 module example.com/myapp；所有 import 必须以该前缀开头，如 import "example.com/myapp/utils"
• 如果只是本地开发，不想暴露域名，用伪域名也行：go mod init myproject，然后 import 就写 "myproject/utils"
• 别在 GOPATH/src 下初始化模块 —— Go Modules 时代，项目可放在任意路径，GOPATH 已无关紧要
• 改完 go.mod 后，删掉 go.sum 并重新 go mod tidy，否则校验会失败

代理配置和 gopls 启动是两个最常被跳过的硬性前提，其他问题大多由它们衍生。路径、模块名、工具链三者对齐了，VS Code 才真正“懂” Go。