go mod init 报错“no Go files in current directory”是因为当前目录无 .go 文件，需先创建 main.go 再执行 go mod init；VS Code 无提示是 gopls 未安装或启动失败，应通过 Go: Install/Update Tools 安装并重启编辑器；go run 报错“cannot find module”说明不在模块根目录或 go.mod 路径不匹配；macOS 上 go install 失败多因 GOROOT 未正确设置、GO111MODULE 未启用或 GOPROXY 未配置国内代理。
go version 能跑，但 go mod init 报错：no Go files in current directory
这不是环境没搭好，是当前目录里没有 .go 文件，go mod init 不会自动创建文件，它只读取已有 Go 源码来推导模块路径。常见于刚建空目录就执行命令。
- 先新建一个
main.go，哪怕只写package main也行 - 再运行
go mod init example.com/hello（模块名可任意，但建议用域名格式） - 如果仍报错，检查当前路径是否确实是你刚建的项目目录（
pwd或ls确认）
VS Code 打开 .go 文件后没提示、没跳转、格式化失效
本质是 gopls（Go 语言服务器）没装或启动失败，不是插件没装——插件只是壳，真正干活的是后台工具链。
- 打开任意
.go文件，看 VS Code 底部状态栏是否有gopls加载中或报错提示 - 按
Ctrl+Shift+P→ 输入Go: Install/Update Tools→ 全选，尤其是gopls和dlv - 如果卡在下载，手动设置代理：
go env -w GOPROXY=https://goproxy.cn,direct - 重启 VS Code，别只重载窗口——完全退出再打开
go run main.go 提示 cannot find module providing package
说明你没在模块根目录下执行命令，或者 go.mod 里声明的模块路径和当前路径不匹配。Go 不再依赖 GOPATH，但严格依赖 go.mod 所在位置。
- 确认
go.mod文件在当前目录（ls go.mod） - 如果
go.mod在子目录，cd 进去再go run - 如果误删了
go.mod，重新go mod init xxx，不要复制别人的 - 避免在
$GOPATH/src下混用旧模式和模块模式，现代项目直接放任意路径即可
macOS 上 go install 工具总超时或失败
Homebrew 安装的 Go 默认没配 GOROOT，而 go install 依赖它定位标准库；同时国内网络直连 proxy.golang.org 基本不可用。
立即学习“go语言免费学习笔记（深入）”；
- 先查
go env GOROOT，如果不是/usr/local/go（pkg 安装）或/opt/homebrew/Cellar/go/x.x.x/libexec（brew 安装），就手动设：go env -w GOROOT=/usr/local/go - 强制启用模块：
go env -w GO111MODULE=on - 换国内代理：
go env -w GOPROXY=https://goproxy.cn,direct -
go install后生成的二进制默认在$GOPATH/bin，确保该路径已加入PATH
GOROOT、GO111MODULE、GOPROXY 这三个值一旦设错，问题会连锁出现，且错误提示往往不指向根源。调试时优先查这三个，比反复重装 Go 有效得多。 
