hello world

在这篇向导文章里，你会了解到关于go编程的一个简单介绍。按步就班阅读下去，你将了解：

• go的安装（如果你还没安装的话）
• 写点简单的“Hello World"的代码
• 使用go相关的命令运行你的代码
• 使用go的包管理工具去找到你能用到你代码里的代码包
• 在外部模块调用函数

准备工作

• 一点编程经验。在下面会提到的代码是十分简洁的，但这会帮助你了解关于函数的相关知识。
• 一个编写代码的工具。你的任何代码编辑器都可以用来编写代码。大多数代码编辑器都对go有一个很好的支持。当下比较流行的编辑器有VSCode（免费）、GoLand（付费）和Vim（免费）等。
• 一个代码控制台。go可以在任何Linux和Mac的终端上很好地运行，也能在Windows上的PowerShell和cmd上运行。

安装go

可以查看本系列的关于安装的部分。

开始写代码

通过hello world开始。

1. 打开一个命令行终端并进入到你的home目录下。

如果是Linux 或Mac：

cd

如果是Windows：

cd %HOMEPATH%

2. 为你的第一份go源码创建一个文件夹。

mkdir hello
cd hello

3. 确认你的代码引用路径

当你的代码引用了包含在其他模块里的代码时，你要通过你代码里对应的模块来对这些依赖进行管理。这些管理模块是通过可以找到包引用路径的go.mod文件实现的。go.mod文件会和你的代码一起保存在你的源码仓库里。

为了可以让你的代码能通过创建一个go.mod文件来让其引用路径生效，可以运行go mod init命令，并定义一个可以引用你代码模块的名称。

在实际的开发中，模块路径往往是保存你代码的仓库路径。比如，模块路径可以是github.com/mymodule。如果你打算让自己的代码发布让别人使用，那么模块路径必须是Go工具可以下载得到的路径。更多关于模块路径命名信息可以点击这里。

根据这篇向导的初衷，我们可以把模块命名为example/hello。

go mod init example/hello

4. 在你的代码编辑器里，创建一个用来写代码的文件hello.go。
5. 粘贴下面的代码到你的hello.go文件里然后保存。

package main

import  "fmt"
func main() {
	fmt.Println("Hello, World!")
}

这是你的go代码。在这段代码里，你做了以下这些事情：

• 定义了一个main包（包是一种将函数分组的方式，由同一目录中的所有文件组成）。
• 引用了流行的fmt包，该包包含了一系列包括但不限于输出到控制台的文本格式化函数。这也是当你在安装go时就自带的标准库包之一。
• 执行一个输出一段信息到控制台的main函数。当你运行main包时，main函数会被默认执行。

6. 执行你的代码看一下问候

go run .

go的run命令是你会在使用go的过程中用到的众多命令之一。使用下面命令可以得到一个列出所有命令的列表：

go help

在外部包里引用代码

当你需要用你的代码实现某个功能但可能已经被别人的代码实现了的话，你可以去找一下你能用到自己代码里的包。

1. 通过一个外部模块让你打印的信息更有趣一点。

（1）访问pkg.go.dev，然后搜索一个名为“quote”的包。
（2）在搜索的结果里找到并点击rsc.io/quote包（如果你看到rsc.io/quote/v3，暂时忽略一下v3这个包）。
（3）在文档部分的序号下面，你可以看到一个你能在你代码里使用的函数列表。你将会用到这些go函数。
（4）在页面的顶部，你可以看到quote包包含在rsc.io/quote模块里。

你可以通过pkg.go.dev网站去找到你可以使用在你自己代码里的别人发布的模块。包都是发布就像rsc.io/quote这样子的模块里，从而让大家都能使用。这些模块也会随着时间增长而更新，你可以更新你的代码来使用这些更新后的模块版本。

2. 在你的go代码里，导入rsc.io/quote包并且写一个对这个包里函数的调用逻辑。
   把你的代码按如下修改：

package main

import "fmt"

import "rsc.io/quote"

func main() {
	fmt.Println(quote.Go())
}

3. 添加新的模块requirements和sums文件。

go会把quote模块作为一个requirement来添加，同时也会添加一个go.sum文件来验证模块。更多关于go模块引用的信息可以点击这里进行查看。
（ps:应该是导入包之后要执行下面语句进行包的导入记录和版本控制）

go mod tidy

4. 执行你的代码并查看你所调用的函数生成的信息。

go run .

可以注意到你的代码引用了go函数打印出了一句谚语。

当你使用go mod tidy的时候，它会找到并下载包含你所导入的包的rsc.io/quote模块。并且，他会默认导入最新版本。