不是必须。Go 1.11+ 默认启用模块模式,只要项目根目录有 go.mod 文件,就可在任意路径编写运行程序,不再强依赖 GOPATH。

Go程序必须放在GOPATH/src下才能正常构建吗?
不是必须。Go 1.11+ 默认启用模块模式(Go Modules),只要项目根目录有 go.mod 文件,就可以在任意路径编写和运行程序,不再强依赖 GOPATH。旧教程强调 GOPATH/src 是因为那时模块未普及,现在硬套会导致新手在桌面或文档目录下写 hello.go 却执行失败——错误提示往往是 go: not in a module 或找不到包。
- 新建项目目录,例如
~/projects/hello,不用管GOPATH - 终端进入该目录,运行
go mod init hello(模块名可任意,但建议与目录名一致) - 此时会生成
go.mod,内容类似module hello,后续所有go run、go build都以此为模块根
为什么用 go run hello.go 而不是先 go build 再执行?
go run 是开发阶段最直接的验证方式:它编译并立即运行单个(或多个)Go源文件,不留下二进制文件。适合快速试错,尤其对 Hello World 这类无依赖的小程序。而 go build 会生成可执行文件,需要手动执行,多一步且容易在当前目录堆满 hello、hello2 等临时文件。
- 确保文件名是
hello.go,内容以package main开头,含func main() - 运行
go run hello.go—— 不需要go.mod也能成功,但建议仍先go mod init养成习惯 - 若报错
command-line-arguments: no Go files in current directory,说明当前没有.go文件,或文件名含空格/非法字符
最简 hello.go 应该长什么样?
不能省略 package main 和 func main(),也不能漏掉 import "fmt"——Go 不允许未使用的导入,所以调用 fmt.Println 前必须显式引入 fmt 包。常见错误是只写 Println("Hello, World!") 而没加 fmt. 前缀,或把 main 写成小写 main(Go 中首字母小写表示包内私有,无法作为入口)。
package main
import "fmt"
func main() {
fmt.Println("Hello, World!")
}
- 文件必须保存为 UTF-8 编码,BOM 会导致编译失败(Windows 记事本易出此问题)
- 行末不能有多余空格或制表符(虽不报错,但可能干扰后续添加逻辑)
- 字符串用双引号,单引号仅用于
rune(如'a'),写成'Hello'会编译失败
运行后没输出或报错 exec: "gcc": executable file not found 怎么办?
这个错误和 Hello World 本身无关,而是 Go 在某些场景下(比如 CGO 启用时)尝试调用系统 GCC,但 macOS 或 Linux 未安装,或 Windows 没配 MinGW。默认情况下纯 Go 程序(如本例)完全不依赖 GCC——只要确认没设置 CGO_ENABLED=1,且没导入任何含 C 代码的包,就可安全忽略该提示或直接禁用 CGO。
立即学习“go语言免费学习笔记(深入)”;
- 临时禁用:运行前加环境变量,例如
CGO_ENABLED=0 go run hello.go(Linux/macOS)或set CGO_ENABLED=0 && go run hello.go(Windows CMD) - 检查是否误启 CGO:执行
go env CGO_ENABLED,返回1表示启用,可运行go env -w CGO_ENABLED=0永久关闭(仅影响当前用户) - 真正要装 GCC 的情况极少,比如后续要用
net包做 DNS 解析(某些系统上),但那已远超第一个程序范畴










