go项目跑不起来多因环境配置错误：先用go version确认是否安装及版本是否合规；goroot须指向go根目录，gobin建议设独立路径并置于path前端；go mod init必须在项目根目录执行，模块名宜用短名；ide自动构建易干扰，应先手动运行go mod tidy再go run。
Go 项目跑不起来，八成卡在环境这一步——不是版本不对，就是 GOROOT 和 GOBIN 混了，或者 go mod 初始化时没切对目录。
确认系统是否已装 Go 及版本是否可用
别急着重装，先看终端里到底有没有 go，以及它是不是你想要的版本：
- 运行
go version，如果报command not found，说明没装或 PATH 没配对 - 输出类似
go version go1.21.6 darwin/arm64是正常的；但若显示go1.18或更低，某些新语法（如泛型完整支持、any别名）可能出问题 - macOS 上通过 Homebrew 装的 Go，路径通常是
/opt/homebrew/bin/go；Linux 用apt install golang容易装到过时版本，建议直接下官方二进制包
手动安装后必须设对这三个环境变量
从官网下载 tar.gz 解压后，只把 bin 加进 PATH 不够——go 工具链依赖 GOROOT 和 GOBIN 的显式声明，否则 go install 会写到系统默认位置（比如 /usr/local/go/bin），导致权限错误或命令找不到：
-
GOROOT必须指向你解压后的根目录，例如/usr/local/go（Linux/macOS）或C:\Go（Windows） -
GOBIN建议设为独立路径，如$HOME/go/bin，避免和GOROOT/bin混淆 -
PATH要同时包含$GOROOT/bin和$GOBIN，且$GOBIN在前，确保go install生成的可执行文件优先被找到
go mod init 必须在项目根目录执行
很多新手在空文件夹里敲 go mod init myapp，结果发现 go run . 报错：无法解析导入路径。根本原因是模块路径和实际目录结构不匹配：
- 假设你打算写一个 HTTP 服务，项目放在
~/projects/hello，那就 cd 进去再运行go mod init hello，不是go mod init github.com/you/hello（除非你真要发布到 GitHub） - 模块名只是逻辑标识，不强制要求是 URL；本地开发用短名更安全，避免后续重命名仓库时一堆 import 路径要改
- 初始化后检查生成的
go.mod文件第一行：module hello—— 如果写成了module .或空，说明命令执行位置错了
第一次 go run 失败？先关掉 IDE 的自动构建
VS Code 的 Go 插件、GoLand 默认启用实时分析，会在你保存 .go 文件瞬间触发 go list 或 go build，而此时 go.mod 可能还没初始化，或 go.sum 缺失，导致弹窗报错“failed to load module information”：
- 临时关闭 VS Code 的
"go.useLanguageServer": false，或在设置里禁用 “Auto-save go.mod” - 用终端手动跑一次
go mod tidy再试go run main.go，比盯着编辑器报错更可靠 - Windows 用户注意：CMD 和 PowerShell 对
$GOPATH展开不一致，一律用 Git Bash 或 Windows Terminal + WSL 执行命令更稳
最常被跳过的细节是：go mod init 后没立刻写 main.go，而是先建子目录放代码——Go 不会自动识别子目录为入口，go run . 只找当前目录下的 main 包，这点和 Python 的包发现机制完全不同。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
