第一个 Go 程序:从 go run 到屏幕上那行字

第一个 Go 程序:从 go run 到屏幕上那行字
隔壁老康难度 ★☆☆☆☆ · 前置:装完 Go 的第一天,我卡在 GOPATH 上 | 一句话结论:Go 的代码不能双击运行,得由
go这个命令替你编译再跑,而编译器报的每一行都在告诉你哪个文件、第几行、第几个字、错在哪。
装 Go 这件事本身没什么好讲的,一路下一步就行。麻烦的是下完那一步之后,编辑器打开,文件夹是空的,你不知道第一个文件该叫什么,也不知道写完该按哪个键。我当年的做法是照着某篇博客抄了一段 package main,存成 test.go,然后双击它,记事本弹出来又关掉,屏幕上一片平静,什么都没有发生。就这么折腾了半小时,才反应过来一件事:Go 的代码不是双击跑的。它没有解释器在后台等你按 F5,也没有虚拟环境要先激活,从源文件到屏幕上那行字,中间横着一个必须由你亲自动手的编译步骤,而这一步在你按对命令之前,连一个字的提示都不会给你。所以这一篇不打算先讲语法,先把这条从文件到输出的路走通,你会建项目、写入口、按下去、看见字、看懂报错、把代码格式化,最后知道自己编出来的那个东西到底是个什么。看完这一篇你不需要记住任何语法,只需要知道一件事:屏幕上有字,是因为你刚才让一个叫 go 的程序替你编译并运行了一遍。
先把这句话记着,后面每一节都会回到它上面来,尤其是最后那节讲编译产物的,你会再见到它一次。
一个文件夹,两个文件
先建一个空文件夹,名字随意,我在自己的机器上叫 hello。然后进去,新建一个文件,文件名必须是 main.go。注意后缀,main.txt 不算,记事本存出来的 main.go.txt 更不算,Windows 默认会把已知后缀藏起来,这一点坑过很多人,存完拿 dir 看一眼真实名字再继续。名字这件事听着琐碎,但它是 Go 少数几个不讲道理的地方:入口文件必须叫 main.go,包必须叫 main,函数必须叫 main,三个 main 缺一个都不行。
文件夹里要放两个文件,而不是一个。第一个是刚建的那个 main.go,第二个叫 go.mod,内容两行就够:
1 | module hello |
第一行是这个模块的名字,名字随便起,不起也行,go mod init 会替你填。第二行是我按哪个版本的规矩写代码,写 1.27 意味着这个目录里的东西要能在 1.27 上编过。
为什么第二个文件在第一篇就要出现,因为它是 Go 从 1.11 之后的基本单位,你可以把它理解成这个目录的身份证,有了它目录才算一个项目,没有它目录就只是一堆文件。它还有一层用处,是告诉所有工具从这个目录往上找边界、找到它为止,所以你在子目录里跑任何 go 命令,它都会往上找到这个文件,而不是要求你在哪跑就放哪。
两个文件,缺一不可,少放到子目录里去也一样找不到。
go.mod 不写在子目录也能找到,往上找。
那三行代码,逐字拆
main.go 里写下面这几行,注意大小写,Go 里大写小写完全是两回事:
1 | package main |
六行代码,三样东西,值得一句一句过。
第一行声明这个文件属于哪个包,Go 里每个文件都属于某个包,包名写在第一行。main 是个特殊的包名,编译器看到它就知道这里要产出一个能直接运行的程序,而不是一个被别人 import 的库。你要是把 main 写成 hello,go run 会立刻甩你一句 package hello is not a main package,它不是嫌名字难听,是找不到入口。
这一行还有一个容易忽略的规矩:包名和目录名不必一致,但同一个目录下的文件必须用一个包名,混着写编译器直接报错。
第二行是借用别人写好的东西。fmt 是标准库里的格式化输出包,Println 就在里面,末尾那个小写的 nl 是 newline 的意思,也就是打完顺带换一行。Go 的规矩是用到什么就 import 什么,用不到的一律不许留,这条规矩比大多数语言都严,下一节会看到它报错的样子。
第三行开始是函数。func main() 是程序的入口,运行时从这一行开始执行,前面那些包级变量先初始化完,再进到这里。花括号里的那一句就是往屏幕上打一行字然后换行,中间那个缩进是 Tab 不是四个空格,这一点 gofmt 会强制执行,你敲四个空格它会给你改成 Tab。
三行代码里没有分号,没有 public,也没有声明返回类型,main 不接收参数也不返回东西。你要是从 C 或者 Java 过来会觉得少了点什么,那些东西确实被拿掉了,理由在下一篇讲类型的时候一起说。
这里只提醒一句,别的地方能省的 Go 都省了,但 main 这个名字省不掉,包名、文件名、函数名三处都得叫 main,错一处编译器都会拦下来。
大小写错了就是另一个名字。
go run 这一下,跑了四件事
在文件所在目录打开终端,敲 go run .,屏幕上出现要打的那行字,事情就成了。注意末尾那个点,它代表当前目录,少了它 go run 会告诉你没有可运行的文件,初学者有一半的莫名其妙是从这个点开始的。
但成了和懂了差得很远,这一下背后至少做了四件事,而每一件都能单独出错。
一是找到当前目录的 go.mod,确认这是个项目,找不到就报 cannot find main module,这个报错跟代码一个字的关系都没有。二是把目录下所有 .go 文件解析一遍,检查语法和类型,这一步出错就是后面要看的那些 file:line:col 开头的行。三是把检查通过的东西编译成机器码,放在一个临时目录里。四是执行那个临时产物,把它的输出接到你的终端上,跑完就把临时文件删掉。
这四步里只有第三步会慢,而它慢不慢取决于你有没有编过同样的东西,跟代码长短几乎无关。这也是为什么你在同一台机器上第二次跑会快得多,跟网络、跟编辑器、跟你有没有关掉浏览器都没关系。
所以 go run 其实是个编译加运行再加打扫的组合动作,它自己不是编译器,也不是解释器。这一点很重要,因为它解释了两个常见现象,一是为什么第一次慢第二次快,二是为什么跑出来的东西不能直接发给别人。第一次慢是因为标准库要现编,第二次命中了编译缓存,至于临时产物,跑完就删了,你想拷也拷不到。我拿一个只有一行输出的程序量过时间,go clean -cache 之后第一次是 3.7 秒上下,什么都不改再跑一次是 0.4 秒,差的这 3.3 秒全花在编译标准库上,跟你的代码一行关系都没有。
第一次慢是正常的,第二次开始就快,快的原因不在你的代码,在编译缓存。
报错怎么读,看三个位置
初学者最容易被红色的一坨字劝退,其实 Go 的编译错误格式非常固定,每行都由四段拼起来,认准这四段就够用了。拿三个最常见的情况举例:
1 | .\main.go:4:2: declared and not used: x |
三段都是同一个骨架。冒号前是文件名,后面两个数字是行号和列号,再后面那句才是真正的话。main.go:4:2 的意思是打开 main.go 往下数第 4 行,再往右数第 2 个字符,位置准到字符,这是 Go 编译器做得比多数工具都好的地方。你把光标挪到那个位置,问题通常就在眼前。
第 4 行,往右数第 2 个字符。
第二段要看的是错误类型,它决定了你该往哪个方向想,三种错误对应三种不同的动作。declared and not used 是你声明了变量但一次都没用过,imported and not used 是你 import 了包但没用,undefined 是这个名字我根本不认识。前两种是 Go 特有的严格,第三种拼写错误占绝大多数,比如把 Println 敲成 Printline,那个大写 L 和小写 l 在等宽字体里长得几乎一样。顺带说一句为什么 Go 对没用到的变量这么不客气,它不是洁癖,是因为没用到的变量通常意味着你写漏了一步,而这一步往往正是 bug 所在,编译期拦下来比上线之后靠日志猜要便宜得多。
先看位置,再看类型,这两样认熟了,绝大部分红字就不用去论坛问了。
gofmt 不是建议,是规矩
Go 社区有一件事是全体统一的,代码长什么样不由你决定,由 gofmt 决定。缩进是 Tab、左花括号跟函数名同一行、import 按字母排序、多余的空格全删,这些不是风格偏好,是工具强制。你不用跟它辩论,它也不给你开关。我故意写了一个格式很乱的版本试了一下,gofmt -l . 直接把文件名吐出来,说明这一个文件不合规矩。想看它到底要改什么,把 -l 换成 -d,它会把差异按 diff 的格式打出来,减号是它要删的,加号是它要加的:
1 | $ gofmt -d main.go |
左边那个版本里,花括号和括号紧贴着前一个字符,右边补上了空格,行首也换成了 Tab。改完之后再跑 gofmt -l .,输出是空的,那时候才算合格。这件事的好处要写一段时间才体会得到,所有 Go 代码长得一样,你在别人的项目里翻文件、在 GitHub 上读 diff、在 review 里讨论逻辑而不是缩进,省下来的注意力很可观。
别跟它较劲,把格式化交给编辑器,你只负责写逻辑那部分。
gofmt -l . 没有输出才算过。
编出来是个什么东西
go run 跑完什么都没留下,想留下一个能发给别人的东西,用 go build:
1 | $ go build -o hello.exe . |
2.4 MB,一个空目录里只有三行代码,编出来 2.4 MB。第一次看到这个数字的人几乎都会问同一句话,怎么这么大。答案在依赖上,Go 默认把用到的运行时和标准库全部静态链进这一个文件,所以它不依赖任何动态库,拷到另一台同架构的机器上直接就能跑。这个取舍非常有 Go 的味道,代价是文件大,收益是部署简单,没有动态库版本问题,没有环境变量问题,一个文件扔过去就能用。那为什么不干脆只用 go run,因为它每次都要重新编译再执行,而且临时产物你拿不到。上线、发给同事、放进容器镜像,用的都是 go build 的产物,go run 是开发期的便利,go build 才是最终形态。
2.4 MB 里有大半是标准库。
你现在该会的东西
到这一步,你已经能自己建项目、写第一个程序、跑起来、看懂三种最常见的编译错误、把代码格式化、编译出一个能拷走的可执行文件。这六件事覆盖了日常的绝大部分,剩下那些运行时行为,等你能写完整程序了再回头看也不迟。
下一件事是把数据放进变量里,也就是为什么 Go 不做隐式类型转换,var 和 := 到底差在哪。先按一次保存,确认文件没存丢,再翻到下一篇。











