go项目初始化失败主因是路径错误或代理未配置：需先建main.go或指定模块名；国内必须设goproxy=https://goproxy.cn,direct；ide如goland需确保加载shell环境变量。
Go 环境在终端里能跑 go version，但新建项目却卡在 go mod init 或依赖拉不下来，大概率不是没装好，而是终端环境变量没生效或代理没设对。
终端里 go 命令可用，但 go mod 报错“no Go files”
这不是环境问题，是命令执行路径错了。Go Modules 初始化默认会扫描当前目录下有没有 .go 文件来推断模块路径。
- 先创建一个空的
main.go（哪怕只写package main），再运行go mod init example.com/myapp - 不想写文件就直接指定模块名：
go mod init example.com/myapp—— 这条命令本身不要求当前有源码 - 绝对别在
$GOROOT（比如/usr/local/go）或系统级目录下执行go mod init，会触发权限拒绝或路径冲突
go get 失败、超时或 404，提示无法访问 proxy.golang.org
国内直连官方代理基本不可用，必须显式设置国内镜像代理，且要确保它在终端启动时就加载。
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐，持久生效） - 如果用 zsh/bash，也可以加到
~/.zshrc或~/.bash_profile：export GOPROXY=https://goproxy.cn,direct - 验证是否生效：
go env GOPROXY输出应为https://goproxy.cn,direct，不是空或https://proxy.golang.org - 注意
direct是 fallback，不能省；多个代理用英文逗号分隔，不要加空格
VS Code / iTerm / PowerShell 里 go 正常，但 Goland 或某些终端打不开 go
IDE 启动时不一定读取你的 shell 配置文件，尤其是桌面快捷方式直启的 Goland，容易漏掉 PATH 中的 $GOROOT/bin。
- macOS/Linux：在 Goland 的
Help → Edit Custom Properties里加一行idea.shell.path=/bin/zsh（换成你实际 shell） - Windows：确认系统环境变量
PATH包含%GOROOT%\bin，且 Goland 不是通过旧版快捷方式启动（建议从终端执行goland测试） - 快速验证：在 Goland 内置终端里运行
which go（macOS/Linux）或where go（Windows），看路径是否指向你安装的 Go
go fmt 保存时不自动格式化
VS Code 或 Goland 的 Go 插件默认启用 gofmt，但一旦被其他配置覆盖或工具缺失，就会静默失效。
- 检查设置里是否误关了
"editor.formatOnSave": false，或设置了"go.formatTool"却没装对应二进制 - 新版 Go 已内置
gofmt，无需额外安装；但若用了gofumpt，得手动运行go install mvdan.cc/gofumpt@latest - 格式化失败通常不报错，只留原样代码——最简单的验证方式是手动执行
gofmt -w main.go看是否成功
真正容易被忽略的是：不同终端启动方式加载的环境变量不一致，go env 在终端里输出的值，未必等于 IDE 内置终端看到的值。每次遇到奇怪的 “命令找不到” 或 “模块拉不下来”，先在对应终端里跑一遍 go env GOPATH GOPROXY GOROOT 对齐再说。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
