答案是path未包含goroot/bin导致go命令不可用。需确认go安装路径（如windows的c:\go\bin、macos/linux的/usr/local/go/bin），检查echo $path或echo %path%是否含该路径，缺失则编辑shell配置文件（如~/.zshrc）添加并source生效，vs code终端也需重启。
go version 命令没反应？检查 PATH 和 GOROOT 是否生效
安装完 Go 后运行 go version 报 “command not found” 或直接无输出，说明系统根本找不到 go 二进制文件。这不是 Go 没装好，而是环境变量没生效。
- 先确认 Go 安装路径：Windows 默认是
C:\Go\bin，macOS/Linux 通常是/usr/local/go/bin；用文件管理器或ls /usr/local/go/bin验证是否存在go文件 - 检查
PATH是否包含该路径：运行echo $PATH（macOS/Linux）或echo %PATH%（Windows CMD），看输出里有没有/usr/local/go/bin或C:\Go\bin - 如果缺失，别直接改系统 PATH 图形界面——编辑 shell 配置文件：
~/.zshrc（macOS Catalina 及以后）、~/.bashrc（旧版 macOS/Linux）或%USERPROFILE%\go\env.bat（Windows 手动批处理） - 改完必须重新加载：
source ~/.zshrc，否则新开终端才生效；VS Code 终端也要重启才能读取新环境
go mod init 报错 “unknown revision”？优先设置 GOPROXY
新建项目后执行 go mod init example.com/hello 没问题，但一加 import "github.com/sirupsen/logrus" 就卡住或报 unknown revision，本质是模块代理没开，国内无法直连 GitHub。
- 必须运行：
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐）或https://proxy.golang.org（官方，需科学上网） - 同时确认模块开关已启用：
go env -w GO111MODULE=on；Go 1.16+ 默认开启，但旧系统或 Docker 容器里可能关着 - 如果用了私有仓库或公司内网 Git，
direct部分不能删——它表示对匹配的域名（如git.internal.company）绕过代理直连 - 临时验证代理是否生效：运行
go list -m -f {{.Dir}} github.com/sirupsen/logrus，能快速返回路径即成功
写完 hello.go 却提示 “package main expected”？注意包声明和文件位置
新建 hello.go 写了 fmt.Println("hi")，但 go run hello.go 报错说缺少 package main，不是语法错了，是 Go 对可执行文件有硬性结构要求。
- 每个可运行程序必须以
package main开头，且必须有func main()函数；缺任意一项都会报错 -
go run只接受单个.go文件或当前目录下所有.go文件——但若目录里混着utils.go（含package utils），就会冲突；建议练习时单独建空目录，只放一个main.go - 不要把文件放在
$GOPATH/src下再用go run；Go Modules 模式下，go run不依赖GOPATH，反而容易因历史路径干扰出错 - 初学阶段完全不用碰
GOPATH：设了GO111MODULE=on后，go mod init生成的go.mod就是项目唯一权威根目录
VS Code 调试不进断点？Go 插件 + dlv 二进制必须匹配版本
点调试按钮后程序一闪而过，断点灰色不可用，或提示 “Could not launch process: fork/exec … no such file or directory”，大概率是调试器没装或版本不对。
- VS Code 的 Go 插件会自动提示安装
dlv（Delve），但点击 “Install” 后可能失败——因为网络问题或权限不足；手动安装更稳：go install github.com/go-delve/delve/cmd/dlv@latest - 装完检查：
dlv version输出的 Go 版本号必须 ≥ 当前go version；比如你用 Go 1.22，但dlv是用 Go 1.20 编译的，就可能不兼容 - VS Code 设置里搜 “go.toolsEnvVars”，确认没有额外覆盖
GOPATH或GOROOT；插件默认用系统 PATH 里的go和dlv，路径冲突会导致静默失败 - 调试前务必在项目根目录（有
go.mod的地方）打开 VS Code，否则插件无法识别模块边界，调试配置会错乱
go run main.go 很快，但卡在环境变量、代理、包结构或调试器上的人远比想象中多；这些不是“配置步骤”，而是 Go 工具链默认行为与本地环境之间的具体摩擦点，绕不开，只能一个个实打实验证。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
