现在装 go 不用配 gopath 和手动加 path，go mod 是默认行为，唯一必须设的是 goproxy（国内用户），其他配置均为可选，强行设置易出错；go version 报错或版本低是 path 混乱或旧版残留所致，需通过 which go 或 where go 定位路径并清理旧安装；go mod init 失败主因是模块路径格式非法，须用 example.com/yourname/projectname 类格式；vs code 提示 gopls 未找到是因未安装或代理未生效，应先设 goproxy 再 go install gopls@latest 并配置插件路径；go run 报 cannot find package 多因模块路径不一致或未在 go.mod 根目录执行。
直接说结论：现在装 Go，不用配 GOPATH，不用手动加 PATH（Windows/macOS 安装包默认做了），go mod 是默认行为，唯一必须设的是 GOPROXY（国内用户）——其他都是可选项，强行配置反而容易出错。
go version 报 command not found 或版本太低怎么办
这不是安装失败，而是 PATH 混乱或旧版残留。常见于：
- macOS 用 Homebrew 装过
go1.16，又手动解压了go1.22.3，但 shell 还在调用旧路径 - Windows 卸载 MSI 后注册表里还留着
GOROOT，新安装的go二进制没被识别 - Linux 用户把
go解压到/opt/go，却忘了把/opt/go/bin加进PATH
实操建议：
- 先运行
which go（macOS/Linux）或where go（Windows），看输出路径是否是你刚装的目录 - 如果不是，删掉旧路径（比如
rm -rf ~/sdk/go1.16），再检查~/.zshrc或~/.bashrc里有没有重复的export PATH=...行 - Windows 用户建议彻底卸载旧版 MSI，再从官网下最新
.msi（如go1.22.3.windows-amd64.msi），它会自动写入PATH和注册表 - 验证：终端重启后执行
go version，必须看到 ≥go1.18的输出，否则模块功能受限
go mod init 失败：failed to load config: unknown module path
这是项目初始化时最常卡住的地方，本质是 go mod init 需要一个合法的模块路径名，但它不校验域名是否存在，只检查格式。
常见错误现象：
-
go mod init myapp→ 报错：malformed module path "myapp": missing dot in first path element -
go mod init 123abc→ 报错：malformed module path "123abc": leading digit
正确做法：
- 模块路径不是随便起的，推荐用
example.com/yourname/projectname格式（example.com只是占位符，不用真有这个域名） - 避免纯字母、数字开头、含下划线或中划线；可用小写字母+数字+点+斜杠组合，如
github.com/you/hello-go、mycorp.io/api - 执行命令时进入空项目目录后直接运行：
go mod init github.com/you/hello-go - 成功后会生成
go.mod文件，第一行是module github.com/you/hello-go，别手动改它
VS Code 提示 “command ‘go.gopls’ not found” 或无法跳转定义
这不是插件没装，而是 gopls（Go 语言服务器）没装或版本不匹配。VS Code 的 Go 插件默认会提示安装，但国内网络经常卡在下载环节。
关键原因：
-
gopls是用go install下载的，而go install默认走GOPROXY；如果没设，就直连golang.org，大概率超时 - VS Code 在非模块模式下（即没
go.mod）可能降级使用旧协议，导致gopls启动失败 - 某些 macOS M 系列机器上，
gopls二进制权限不对，需手动chmod +x
实操建议：
- 先确保已全局设置代理：
go env -w GOPROXY=https://goproxy.cn,direct - 然后手动安装：
go install golang.org/x/tools/gopls@latest（注意末尾@latest） - 安装完检查位置：
go list -f '{{.Target}}' golang.org/x/tools/gopls，输出类似/Users/you/go/bin/gopls - VS Code 设置里搜
go.gopls，把go.gopls.path改成上面那个完整路径（不要只填gopls） - 重启 VS Code，打开带
go.mod的文件夹，状态栏左下角应显示gopls (v0.x)
go run main.go 报错：cannot find package “xxx”
这通常不是包真丢了，而是 Go 不知道该去哪找——尤其当你混用传统 GOPATH 和模块模式时。
典型场景：
- 你在
$GOPATH/src/github.com/xxx/yyy下写了代码，但没在该目录运行go mod init - 你用了
import "golang.org/x/sys/windows"，但没执行go get golang.org/x/sys - 你用
go run .运行整个目录，但目录下有多个main包，Go 不知道选哪个
解决逻辑很直接：
- 只要项目有
go.mod，所有import都走模块解析，go run会自动调go mod download拉依赖，不需要提前go get - 如果报某个
x/xxx找不到，先确认你 import 的路径拼写完全一致（大小写、斜杠方向） - 运行前确保在项目根目录（即含
go.mod的目录），执行go run main.go，不是go run ./main.go或go run ./src/main.go - 仍失败？临时关模块模式测试：
GO111MODULE=off go run main.go，如果这时好了，说明问题出在模块路径或代理上
真正麻烦的点往往藏在细节里：比如 go.mod 里写的模块名和 import 语句开头不一致，或者 gopls 缓存没刷新，又或者 go env GOPROXY 看着设了，实际 shell 没重载——这些地方一漏，就会卡住半天。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
