能直接 go run 出 “hello, world!” 就算配置成功；需满足 package main 和 func main() 两个硬性条件，import "fmt" 不可省略，文件编码须为 utf-8（no bom），无需 ide、gopath 或 go mod init。
能直接 go run 出 “Hello, World!” 就算配置成功，不需要 IDE、不用配 GOPATH、也不用初始化模块。
用命令行快速验证 Go 是否可用
打开终端（Windows 用 CMD 或 PowerShell，macOS/Linux 用 Terminal），执行：
go version
如果输出类似 go version go1.22.5 windows/amd64，说明 Go 已正确安装且 PATH 配置无误。若提示 command not found: go，重点检查 %GOROOT%\bin（Windows）或 $GOROOT/bin（macOS/Linux）是否在系统 PATH 中。
接着，在任意空文件夹下创建 hello.go，内容仅需三行：
package main
import "fmt"
func main() { fmt.Println("Hello, World!") }
保存后运行：
go run hello.go
看到输出即通过测试。常见失败点包括：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
hello.go文件名拼错，或后缀不是.go - 用记事本保存时选了
UTF-8 with BOM，导致解析失败（换用 VS Code/Notepad++ 保存为纯 UTF-8） - 当前目录下有多个
.go文件，而其中某个缺少func main()，go run会尝试全部编译并报错
为什么不用 go mod init 就能跑通
go run 对单文件无依赖场景完全绕过模块系统。只要满足两个硬性条件：package main + func main()，它就直接编译执行，不读 go.mod，也不查代理。
如果你已经手动生成了 go.mod 却遇到 go: cannot find main module，大概率是文件损坏或路径混乱，直接删掉 go.mod 再试即可。新手不必一上来就 go mod init——它只在你要引入第三方包或后续打包时才有意义。
GoLand 或 VS Code 里运行失败的典型原因
IDE 报错往往不是环境问题，而是项目结构或配置偏差：
- GoLand 新建项目时
GOROOT显示红色感叹号 → 点右侧Add SDK → Download，别手动填路径 - VS Code 提示 “No Go files in workspace” → 确保打开的是包含
hello.go的**文件夹**，不是单个文件；且文件必须在工作区根目录下（不要嵌套太深） - 运行后控制台空白 → 检查
fmt.Println是否漏写括号或引号，或者函数体没写在func main()大括号内 - 报错
cannot run non-main package→ 文件开头写了package hello而非package main
容易被忽略但关键的细节
Go 对语法和命名极其严格，容错率低：
-
func main()必须全小写，不能是Func Main()或func Main() - 不能带参数、不能有返回值，写成
func main(args []string)或func main() int都会编译失败 -
import "fmt"不可省略——Go 没有内置print，所有 I/O 都靠标准库 - 文件编码必须是 UTF-8（no BOM），Windows 记事本默认带 BOM，这是新手最常踩的坑
真正卡住的，往往不是环境装没装好，而是某一行空格、换行或大小写不对。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
