Go 1.16+默认启用模块模式，GOPATH已退居二线，go run报错“no Go files”主因是缺失go.mod文件；需先执行go mod init初始化模块，确保代码在有效模块上下文且路径干净，再配合正确PATH和终端启动VS Code方可正常开发。
Go 环境装完却 go run 报错、go env 显示路径混乱、VS Code 里没代码提示——不是你手残，是现代 Go（1.16+）默认启用模块模式后，GOPATH 已退居二线，但很多教程还在教你怎么配它。
go version 能跑但 go run 报 “no Go files in current directory”
这是最常被忽略的起点问题：Go 不再强制要求代码必须放在 $GOPATH/src 下，但 go run 仍需识别当前目录是否属于一个有效的模块或包上下文。
- 先执行
go mod init example.com/hello（哪怕只是临时项目），生成go.mod文件；没有它，Go 会拒绝编译非标准路径下的main包 - 确保文件名是
xxx.go，且包声明为package main；Go 对大小写和命名敏感，hello.go可以，Hello.go或main.txt都不行 - 别在系统根目录、用户桌面或带空格/中文路径下试；PowerShell 默认可能启动在
C:\Users\你的名字，建议切到C:\dev\hello这类干净路径再操作
go env -w 设置不生效，尤其是 Windows PowerShell
PowerShell 的执行策略（ExecutionPolicy）默认阻止脚本修改环境变量，go env -w GOPATH=... 表面成功，实则只影响当前会话，关掉窗口就丢。
- 运行
Get-ExecutionPolicy，若返回Restricted，先执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（仅当前用户，无需管理员） -
go env -w写入的是$HOME/go/env文件，不是注册表或系统变量；务必用go env命令验证，而不是靠echo $env:GOPATH - 如果用 Chocolatey 安装 Go，它默认不初始化
GOPATH；手动补一句go env -w GOPATH=$HOME\go，再确认go env GOPATH输出是否是你预期的路径
VS Code 中 Go 插件报 “GOPATH not set” 却能跑通命令行
这不是插件 bug，是 VS Code 启动方式导致的环境变量加载不全。直接双击图标启动的 VS Code，不会读取你的 $PROFILE 或 .zshrc，也就看不到你在终端里设置的 GOROOT 或 GOBIN。
立即学习“go语言免费学习笔记（深入）”；
- 不要双击图标，改用终端启动：
code .（macOS/Linux）或code .在 PowerShell 中执行（Windows） - 检查 VS Code 底部状态栏右下角是否有 Go 版本号；没有的话，点它 → “Install Go Tools”，让插件自动下载
gopls、dlv等工具 - 如果仍提示
GOPATH相关警告，打开设置（Ctrl+,），搜go.gopath，把值设为与go env GOPATH一致的路径；现代插件其实不依赖它，但显式配置可消除干扰
go build 生成的二进制在另一台机器上运行失败
Go 默认静态链接，但如果你用了 cgo（比如调用 SQLite、OpenSSL 或某些 GUI 库），就会动态依赖系统 C 库——这正是跨机器失败的根源。
- 先确认是否启用了 cgo：
go env CGO_ENABLED；返回1表示启用，0表示禁用 - 想彻底静态编译，构建前加环境变量：
CGO_ENABLED=0 go build -o hello（Linux/macOS）或$env:CGO_ENABLED="0"; go build -o hello.exe（PowerShell） - 若必须用 cgo（如需要 DNS 解析或系统证书），目标机器需安装对应运行时库；Windows 上常见缺失
vcruntime140.dll，可打包 Visual C++ Redistributable
真正卡住人的从来不是“怎么装”，而是“装完之后哪条路径被谁读、哪条变量被哪个进程忽略”。模块模式下，go.mod 是事实上的项目根标识，GOROOT 只管工具链，GOPATH 仅影响 go install 输出位置——这些边界一旦模糊，后续所有调试都会变成猜谜。
