先运行go version，若输出版本号则命令可用；否则检查path是否包含go的bin目录（windows为c:\go\bin，macos/linux为/usr/local/go/bin），并确保终端已重启或执行source刷新配置。
go 环境没配好，连 go run 都会报错，微服务连编译都过不了——别跳步骤，先让 go version 能跑出来。
怎么验证 go 命令是否真可用？
很多人以为双击安装完就万事大吉，结果在终端里输 go version 提示“command not found”。这不是没装好，是 PATH 没生效。
- Windows：安装后重启命令提示符或 PowerShell；如果仍不行，手动检查系统环境变量里
Path是否含C:\Go\bin（或你自定义的安装路径下的bin目录） - macOS/Linux：安装 pkg 或 tar.gz 后，
/usr/local/go/bin必须加进 shell 配置文件（~/.zshrc或~/.bash_profile），且要执行source ~/.zshrc才生效 - 别信 GUI 终端（比如 VS Code 内置终端）自动继承环境变量——它可能没读你的 shell 配置，新开一个纯 Terminal 再试
GOROOT 和 GOPATH 还需要手动设吗？
Go 1.16+ 默认启用模块（go mod），GOPATH 已不再是硬性约束；但 GOROOT 仍必须正确指向 Go 安装根目录，否则 go build 可能用错标准库。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
-
GOROOT通常由安装程序自动设好（Windows/msi、macOS/pkg 都会写），Linux 手动解压时需显式导出：export GOROOT=/usr/local/go -
GOPATH现在可不设——只要项目根目录有go.mod，go命令就会以当前目录为模块根，不再依赖GOPATH/src - 若仍想设
GOPATH（比如习惯放第三方工具到$GOPATH/bin），建议只设一个路径，避免多路径导致go install行为不可预测
VS Code 里 go 插件报 “gopls not found” 怎么办？
这不是插件坏了，是 gopls（Go 语言服务器）没装或版本不匹配。VS Code Go 插件默认尝试自动安装，但常因网络或权限失败。
- 先在终端运行：
go install golang.org/x/tools/gopls@latest——注意不是go get，go install才写入$GOBIN（默认$GOPATH/bin） - 确认
gopls在 PATH 里：which gopls或gopls version - VS Code 设置里搜
go.gopls.path，填绝对路径（如/home/you/go/bin/gopls），避免插件找不到二进制 - 别忽略
dlv（Delve 调试器）——微服务调试离不开它，同样要go install github.com/go-delve/delve/cmd/dlv@latest
为什么 go mod init 后还 import 不了本地包？
微服务项目常拆多个子模块（如 user-service、auth-service），但 Go 不像 Java 那样靠 classpath 扫描——它严格依赖导入路径与文件系统结构匹配。
-
go mod init example.com/myservice后，所有import必须以example.com/myservice/...开头，不能用相对路径或./subpkg - 跨模块引用（比如
user-service引shared/utils）得用完整模块路径：import "example.com/shared/utils"，且该模块需已go mod publish或通过replace本地链接 - 常见坑：把项目建在
$GOPATH/src下却没按路径命名模块，导致go list无法解析导入路径
go 命令本身在哪、gopls 能不能启动、import 路径为什么总 resolve 不到——这些细节不厘清，后面所有服务注册、gRPC 接口、Docker 构建都会反复报错。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
