go version报错说明path未生效，需关闭所有旧终端并新开窗口；windows下常见因msi未自动写入path或安装路径含空格，应手动添加go\bin到用户级path并重启终端。

go version 命令报错或无输出，说明环境变量没生效

安装完 .msi 或 .pkg 后，常见问题是命令行里输 go version 提示“不是内部或外部命令”。这不是安装失败，而是 shell 没读到新 PATH。

• Windows：必须关闭所有已打开的 CMD/PowerShell 窗口，再新开一个——旧窗口不会自动继承新环境变量
• macOS/Linux：如果用 ~/.zshrc 配置，但终端默认启动的是 bash，就得改 ~/.bash_profile；反之亦然。执行 echo $SHELL 确认当前 shell 类型
• Linux 手动解压后忘了运行 source ~/.bashrc（或对应配置文件），PATH 就不会更新

go run main.go 报错 “no Go files in current directory”

这个错误不是代码写错了，而是当前目录下没有合法的 Go 源文件，或者文件名/包声明不匹配。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

• 确保文件名是 main.go（不能叫 hello.go 或 test.go 除非你显式指定）
• main.go 开头必须是 package main，且包含 func main() 函数
• 不要把文件放在 $GOPATH/src 以外的嵌套子目录里还指望 go run . 自动识别——Go Modules 模式下，只要目录里有 go.mod 就行，但首次初始化得先 go mod init example.com/hello
• 如果用 VSCode，确认右下角状态栏显示 “Go” 语言模式，否则可能被当成纯文本，保存时也不会触发格式化或检查

go build 生成的可执行文件无法运行（尤其 Windows）

go build 默认生成当前平台原生二进制，但行为受 GOOS/GOARCH 影响，且 Windows 下容易忽略扩展名。

• Windows 上 go build 输出的是 main.exe，不是 main；直接输 ./main 会报错，必须输 ./main.exe 或加 .exe 后缀
• 想跨平台编译（比如在 macOS 编译 Windows 版），得提前设环境变量：GOOS=windows GOARCH=amd64 go build -o hello.exe
• Linux/macOS 上生成的二进制默认无执行权限？极少发生，Go 编译结果自带可执行位；但若从 Windows 共享盘复制过来，可能丢失权限，用 chmod +x ./main 补上
• go build -o 指定输出路径时，目标目录必须存在，否则会静默失败（不报错但没生成文件）

依赖拉取超时或 module lookup failed

国内直连 proxy.golang.org 基本不可用，不配代理的话 go get、go mod download 会卡住或失败。

• 执行这三条命令（永久生效）：
  go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=sum.golang.org
go env -w GO111MODULE=on
• goproxy.cn 是七牛云维护的公开镜像，比 https://goproxy.io 更稳定；direct 表示代理查不到时回源官方，避免私有模块失效
• 验证是否生效：go env GOPROXY 应输出 https://goproxy.cn,direct
• 如果项目已有 go.mod 但依赖缺失，别用 go get 盲目拉，先 go mod tidy ——它会自动补全依赖并校验 checksum

实际跑通第一个程序，核心就三步：装对版本、go version 能回显、main.go 里有 package main 和 func main()。其余问题，八成出在环境变量、代理、或文件/目录结构上——这些地方没标准答案，只有具体路径和明确命令。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！