顺利运行第一行代码的Go语言环境搭建法-Golang-PHP中文网

go version报错说明path未配置：windows需将c:\go\bin加入系统path，macos/linux需在~/.zshrc中添加export path=$path:/usr/local/go/bin并source生效。

顺利运行第一行代码的go语言环境搭建法

安装完 go 后输 go version 报 'go' 不是内部或外部命令，说明系统根本找不到 go 可执行文件。这不是 Go 没装好，而是 PATH 没生效。

Windows：检查系统环境变量里 Path 是否包含 C:\Go\bin（默认路径），别漏掉 \bin；如果改过安装路径，得填你实际的 xxx\go\bin
macOS/Linux：确认 ~/.bash_profile 或 ~/.zshrc 里写了 export PATH=$PATH:/usr/local/go/bin（或你解压的实际路径），然后必须运行 source ~/.zshrc（macOS Catalina 后默认 shell 是 zsh）
别信“安装程序自动配好了”——某些 MSI 版本在非管理员权限下安装，Path 只写进了当前用户变量，而命令行可能以不同上下文启动，建议手动补一遍系统级 Path

Go 1.16 起默认启用模块（GO111MODULE=on），但如果你在任意目录直接 go run main.go，会报 go: no required module provides package command-line-arguments。这不是代码错，是模块上下文缺失。

Go语言（Golang）1.26.0

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

下载

进到项目目录后，先跑 go mod init example.com/hello（模块名可任意，但不能是 main 或空字符串）
模块名只是逻辑标识，不影响编译结果，但必须存在；不设代理时，模块初始化会尝试连官方 proxy，国内常卡住，可加 -mod=mod 强制本地解析：go mod init example.com/hello -mod=mod
如果只想快速验证语法，不用模块：把 main.go 放进 $GOPATH/src 下某个子目录（如 $GOPATH/src/hello/main.go），再 go run main.go 就能绕过模块检查（但不推荐长期用）

终端一闪而过、或者 VS Code 集成终端没显示任何文字，常见于 Windows 上双击 main.exe 运行，或用 go run 时终端被意外关闭。

别双击 exe 文件——它会开窗、打印、立刻退出。用命令行：进目录后输 go run main.go 或 .\main.exe
VS Code 中确保在集成终端（Terminal → New Terminal）里执行，且当前工作目录是 main.go 所在文件夹；右键菜单里的 “Run Code” 插件可能用错解释器，优先用终端手动敲
检查 main.go 是否真在 package main 下，且 func main() 拼写全小写、括号匹配、花括号闭合——少一个 } 会导致编译失败但错误信息被滚动刷走

go get 或 go mod download 卡在 Fetching ... 或直接报 403 Forbidden，本质是 Go 默认走 https://proxy.golang.org，国内访问不稳定或被限。

立即设置国内代理：go env -w GOPROXY=https://goproxy.cn,direct（推荐）或 https://mirrors.aliyun.com/goproxy/,direct
direct 是 fallback，表示代理不可用时直连；别漏掉逗号和 direct，否则所有请求都走代理，一旦代理挂掉就彻底断网
如果公司内网禁外网，需联系 IT 配置私有 proxy 地址，或临时用 go env -w GOPROXY=off 关闭模块代理（仅限离线开发）

真正卡住人的从来不是语法，而是 go 命令本身在哪、模块要不要初始化、输出去哪了、依赖从哪来——这四件事没理清，fmt.Println 就永远停在编辑器里。