go环境问题核心在于path配置、模块初始化和包名一致性：需正确设置goroot与path，go mod init时模块名须与import路径匹配，main包文件必须声明package main并含func main()，变量声明需区分:=（函数内）与var（包级或函数内）。
go version 命令报错或显示“command not found”
说明 Go 二进制文件没进系统 PATH，最常见于 Windows 手动解压安装、Linux/macOS 未配置 GOROOT 或 PATH。
检查方式：运行 which go（macOS/Linux）或 where go（Windows），无输出即未生效。
- macOS/Linux：在
~/.zshrc或~/.bash_profile中追加两行（路径按你实际安装位置调整）：export GOROOT=/usr/local/go<br>export PATH=$PATH:$GOROOT/bin
然后执行source ~/.zshrc - Windows：在系统环境变量中新增
GOROOT（如C:\Program Files\Go），再把%GOROOT%\bin加到PATH里 - 验证：重启终端后运行
go version，应输出类似go version go1.22.5 darwin/arm64
gomod init 后 go build 报 “no required module provides package …”
这是模块路径与导入路径不匹配导致的典型错误，尤其发生在项目不在 $GOPATH/src 下、又没用 go mod init 正确初始化时。
Go 1.16+ 默认启用 module 模式，go build 不再依赖 GOPATH，而是靠 go.mod 文件里的模块路径解析 import。
- 确保你在项目根目录下运行
go mod init example.com/myapp（模块名可以是任意合法域名/路径，不必真实存在） - 所有
import语句中的包路径，必须以该模块名为前缀（比如example.com/myapp/utils），否则 Go 无法定位本地子包 - 如果只是想快速跑通 hello world，且无跨包引用，可直接在空目录下写
main.go并运行go run main.go，无需go mod init
main 函数不执行或报 “package main is not a main package”
Go 要求可执行程序必须满足两个硬性条件：文件属于 main 包，且包含 func main() 函数。缺一不可。
常见误操作包括：
- 文件开头写了
package utils或package lib—— 改成package main -
main.go里写了func Main()（首字母大写）—— Go 是大小写敏感的，必须是func main() - 文件里有语法错误（比如
import后多写逗号、括号不匹配），导致编译失败，但错误提示可能被忽略 - 用了
go build生成二进制却没运行，误以为没执行 —— 记得加./myapp手动执行，或直接用go run main.go
变量声明时 := 和 var 混用引发编译错误
:= 是短变量声明，只能用于函数内部；var 可用于包级或函数内，但规则更严格。
典型报错：cannot declare new variables outside of functions 或 no new variables on left side of :=。
- 包级变量（文件顶部）只能用
var name type = value或var name = value，不能用:= - 函数内首次声明可用
name := value；再次赋值必须用=，否则报错 - 多个变量同时声明时，
var a, b int = 1, 2合法，但a, b := 1, 2也合法；而a, b := 1, "hello"会触发类型推导，a 为 int，b 为 string - 注意：
if cond { x := 1 }中的x作用域仅限 if 块内，外面不可访问
go mod init my-app 写成 my_app），后续 import 就可能全崩。动手前先确认当前目录、模块名、import 路径三者是否一致，比反复重装 Go 有效得多。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
