能跑go version、能拉第三方包、编辑器能跳转补全即算配好；go version报错是环境变量未生效，需重启终端并用where/which验证路径；拉包失败需配置GO111MODULE=on、GOPROXY=https://goproxy.cn,direct及GOSUMDB；VS Code补全失效主因是gopls未安装或项目缺go.mod，应手动go install gopls@latest并重载窗口。

能跑 go version、能拉第三方包、编辑器能跳转补全——这三件事齐了，环境就算配好了。其他都是可选项。

go version 报“不是内部或外部命令”？

这不是没装好，是环境变量根本没生效。Windows 的 .msi 安装包虽会自动写入 Path，但已打开的 CMD/PowerShell 不会重读系统变量。

• 必须关闭所有终端窗口，再新开一个，再执行 go version
• 验证路径是否写对：运行 where go（Windows）或 which go（macOS/Linux），应返回类似 C:\Go\bin\go.exe 或 /usr/local/go/bin/go
• 如果仍失败，手动检查系统环境变量里的 Path，确认包含 C:\Go\bin（Windows 默认）或 /usr/local/go/bin（Linux/macOS 默认）

go run main.go 成功，但加 import 第三方库就报错？

本质是模块管理没开，或代理没配对。Go 1.16+ 默认启用模块，但国内不配代理基本拉不到包。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

• 执行这三条命令（永久生效）：
  go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=sum.golang.org direct
• direct 很关键：当代理找不到包时，会自动回源官方校验，避免因镜像滞后导致 sum mismatch
• 验证：运行 go env | findstr GOPROXY（Windows）或 go env | grep GOPROXY（macOS/Linux），输出应含 https://goproxy.cn

VS Code 提示“install tools”却一直卡住或补全失效？

不是插件没装，是 gopls（Go 语言服务器）根本没装上或没识别到模块路径。

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

• 先确保 GOPROXY 已配置（见上一条），再在 VS Code 内置终端中手动运行：
  go install golang.org/x/tools/gopls@latest
• 安装完成后，按 Ctrl+Shift+P → 输入 “Developer: Reload Window” 强制重载
• 若仍无效，检查 gopls 是否在 $GOPATH/bin 下存在；Go 1.21+ 推荐不设 GOBIN，让工具自动装到 $GOPATH/bin
• 打开项目前，先在项目根目录执行 go mod init xxx，确保有 go.mod 文件，gopls 才能正确识别模块上下文

最容易被忽略的是：每次改完环境变量或代理配置，都必须新开终端验证；gopls 启动依赖 go.mod 存在且路径被正确识别，空文件夹里开 VS Code 是不会触发模块加载的。