Go语言环境搭建后如何写第一个程序_Hello World示例

2026-02-02 00:00:00 作者：P粉602998670

不是必须。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 代码的包，就可安全忽略该提示或直接禁用 C

GO。

立即学习“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 解析（某些系统上），但那已远超第一个程序范畴