Go程序必须以package main开头且含func main(),输出用fmt.Println并import "fmt",go run快速验证,go build生成可执行文件,无需早期配置GOPATH或go mod。

main函数必须在main包里,否则编译直接报错
Go 不像脚本语言那样能直接跑单个文件;它要求可执行程序的入口必须是 main 函数,且这个函数必须定义在 main 包中。漏写 package main 或写成 package hello,go run 会直接失败,错误信息是:main redeclared in this block 或更常见的 no buildable Go source files。
- 文件开头第一行必须是
package main,不能有空行或注释挡在前面 -
main函数签名必须严格为func main(),不能带参数、不能有返回值 - 一个目录下只能有一个
main函数;如果误把两个.go文件都写了func main(),go run .会报multiple main functions
用 fmt.Println 而不是 print 或 console.log
刚从 Python 或 JavaScript 切过来的人容易下意识写 print("hello") 或 console.log("hello"),Go 里没这俩东西。输出靠的是标准库 fmt 包里的函数,最常用、最安全的就是 fmt.Println。
- 别漏掉
import "fmt",否则编译报undefined: fmt -
fmt.Print不换行,fmt.Println自动加换行,新手建议无脑用后者 - 不要用
fmt.printf(小写 p)——Go 区分大小写,printf根本不存在,正确是fmt.Printf - 示例就三行:
package main、import "fmt"、func main() { fmt.Println("Hello, World!") }
go run 和 go build 的区别直接影响调试节奏
写完代码后怎么跑?go run hello.go 是最快的验证方式,它编译并立即执行,但不留下二进制文件;而 go build hello.go 会生成一个可执行文件(比如 hello),之后可以反复运行,不依赖 Go 环境。
Go 配置库,使用 spf13/viper — 分层优先级(flag > env >file > KV > default),提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 开发阶段优先用
go run,改一行、跑一次,省去手动删旧二进制的麻烦 - 如果文件名不是
main.go,必须显式写全路径,比如go run main.go;go run .只在当前目录有且仅有一个main包时才有效 -
go build生成的二进制默认和源文件同名(不含.go后缀),Windows 下是hello.exe,别忘了加.exe后缀去执行 - 想指定输出名:用
go build -o myapp hello.go
GOPATH 和 Go Modules 在第一个程序里其实可以完全忽略
网上很多老教程一上来就讲 GOPATH、src 目录结构,现在(Go 1.16+ 默认启用 modules)根本不需要。只要文件是独立的 main 包,没 import 第三方库,go run 就能直接跑通。
立即学习“go语言免费学习笔记(深入)”;
- 别急着初始化
go mod init——没引入外部包时,它只多生成一个go.mod文件,对 Hello World 没任何帮助 - 如果你不小心在项目里执行了
go mod init example.com/hello,又没后续依赖,这个go.mod文件可以放心删掉,不影响运行 - 真正要关心模块,是当你第一次
import "github.com/some/pkg"的时候,那时go命令会自动补全go.mod并下载依赖
第一个程序真正的门槛不在语法,而在对“包即编译单元”和“命令行驱动构建”的适应。很多人卡住,是因为把 Go 当成脚本写了,却忘了它本质是个静态编译语言——少一行 package main,或者 import 写错大小写,就再也跑不起来。

















