使用Golang创建第一个项目需要完成环境准备、模块初始化、程序编写和运行验证几个核心步骤,整个过程操作逻辑清晰,新手按照流程操作即可快速完成第一个可运行的Go程序。

环境准备
在开始创建项目前,需要先完成Golang环境的安装。可以前往Golang官方下载对应操作系统的安装包,安装完成后打开终端输入以下命令验证环境是否配置成功:
go version
如果终端输出了Go的版本信息,说明环境已经安装成功,可以继续后续操作。
初始化项目模块
Go语言从1.11版本开始引入了模块机制,用来管理项目的依赖和版本,创建新项目时首先需要初始化模块。我们可以先在本地创建一个用于存放项目的文件夹,比如命名为first-go-project,然后进入该文件夹执行模块初始化命令:
go mod init first_go_project
执行完成后,项目文件夹下会生成一个go.mod文件,这个文件用来记录项目的模块名称和依赖信息,后续项目引入第三方依赖时,相关信息都会自动更新到这个文件中。
编写Hello World程序
模块初始化完成后,就可以编写第一个Go程序了。在项目文件夹下创建一个名为main.go的文件,文件内容如下:
package main // 声明当前文件属于main包,可执行程序必须属于main包
import "fmt" // 引入fmt包,用于输出内容
func main() { // 主函数,程序执行的入口
fmt.Println("Hello World") // 调用fmt包的Println方法输出Hello World
}
这里需要注意几个关键点:Go语言的可执行程序必须声明为main包,并且必须包含main函数作为程序入口;import语句用来引入需要使用的标准库或者第三方包,这里引入的fmt是Go语言的标准输出包。
运行程序并验证结果
编写完成main.go文件后,我们可以在终端中执行以下命令运行程序:
go run main.go
如果程序运行正常,终端会输出Hello World内容。如果需要将程序编译为可执行文件,可以执行以下命令:
go build main.go
执行完成后,项目文件夹下会生成对应操作系统的可执行文件,直接运行该文件也可以得到相同的输出结果。
常见问题排查
新手在操作过程中可能会遇到几个常见问题:
- 执行
go mod init命令时提示命令不存在,一般是Go环境没有配置到系统环境变量中,需要检查环境变量配置。 - 运行程序时提示找不到main包,需要检查文件开头的package声明是否为main,以及是否包含main函数。
- 编译后的可执行文件无法运行,需要检查操作系统的执行权限,Linux或者macOS系统可以通过chmod命令添加执行权限。
按照以上步骤操作,就可以完成第一个Golang项目的创建、初始化和运行,后续可以在此基础上扩展更多功能,学习Go语言的更多语法特性。
Golang初始化模块Hello_WorldGo项目创建修改时间:2026-07-13 10:12:18