已安装Go且版本≥1.19并配置正确：运行go version验证版本，检查$PATH含Go bin路径，GOROOT和GOPATH需正确设置；首次运行需go mod init初始化模块，避免no required module错误。
确认系统是否已安装Go及版本是否够用
直接在终端运行 go version，如果返回类似 go version go1.21.0 darwin/arm64 的结果，说明已装且版本较新；若提示 command not found: go 或版本低于 go1.19，就得重装。旧版（如 go1.16）可能不支持 go.work 或泛型完整特性，CI 构建或依赖模块时容易报错。
检查 $PATH 是否包含 Go 的 bin 目录：运行 echo $PATH，确认输出里有类似 /usr/local/go/bin（macOS/Linux）或 C:\Go\bin（Windows）。没有就手动加，别跳过这步——很多“命令能执行但 go run 失败”的问题根源在这。
下载安装包时认准官方源和对应架构
去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载，别用第三方镜像或包管理器（如 Homebrew 的 go 包），它常滞后一两个小版本，且 macOS 上可能默认装成 Intel 版本，而 M 系列芯片需要 ARM64 版才能发挥性能。
安装后务必验证：go env GOPATH 应返回非空路径（默认是 $HOME/go），go env GOROOT 应指向安装目录（如 /usr/local/go）。这两个环境变量影响 go get 行为和模块缓存位置，改错会导致依赖拉取失败或 go mod download 报 cannot find module providing package。
立即学习“go语言免费学习笔记（深入）”；
- macOS Apple Silicon：选
go1.x.x.darwin-arm64.pkg - Intel Mac / Windows x64：选
go1.x.x.windows-amd64.msi或.pkg - Linux：解压后手动设
GOROOT，别依赖系统包管理器的软链接
写第一个程序前先绕过 go mod 初始化陷阱
新手常卡在 go run hello.go 报错 no required module provides package。这不是代码错，而是 Go 1.16+ 默认启用模块模式，不在模块内运行会拒绝加载。
快速绕过方法：进任意空目录，先执行 go mod init example.com/hello（模块名可任意，不用真能解析），再写 hello.go：
package main
import "fmt"
func main() {
fmt.Println("Hello, World!")
}
然后 go run hello.go 就能跑通。不初始化也能强制运行：加 -mod=mod 参数（go run -mod=mod hello.go），但仅限临时调试，长期项目必须规范用 go mod。
注意：如果当前目录已有 go.mod 但路径含中文或空格，go run 可能静默失败——换到纯英文路径再试。
控制台交互调试别只靠 fmt.Println
真实开发中，光打印变量值不够。用 log 包加时间戳和文件行号更高效：
import "log"
log.SetFlags(log.Lshortfile | log.LstdFlags)
log.Println("debug info") // 输出形如 hello.go:8: debug info
调试 CLI 输入时，fmt.Scanln 容易因换行符卡住，优先用 bufio.NewReader(os.Stdin).ReadString('\n')，并记得 strings.TrimSpace() 去首尾空白。
常见坑：go run 每次都编译新二进制，快但看不到生成文件；想留可执行文件，用 go build -o hello hello.go，之后直接 ./hello 运行——这对测试命令行参数传递更直观。
模块路径、GOPROXY 设置、CGO_ENABLED 开关这些进阶项，等你遇到具体错误（比如 cannot use cgo 或 proxy.golang.org refused）再查，初始阶段按默认走最稳。
