Golang环境搭建完成后如何编写并运行第一个Hello World程序-Golang-PHP中文网

Golang环境搭建完成后如何编写并运行第一个Hello World程序

P粉602998670

发布： 2025-08-30 10:07:01

原创

613人浏览过

答案：编写并运行Go语言“Hello World”程序需创建main.go文件，写入package main、import "fmt"和func main()代码，通过go run main.go运行。

golang环境搭建完成后如何编写并运行第一个hello world程序

在Golang环境搭建完成后，编写并运行第一个“Hello World”程序是一个非常直接且基础的步骤。你只需要创建一个

.go

登录后复制

文件，写入几行核心代码，然后通过命令行工具执行它。这个过程通常包括定义一个主包（

package main

登录后复制

），导入用于打印输出的

fmt

登录后复制

包，并实现一个

main

登录后复制

函数，其中包含

fmt.Println("Hello, World!")

登录后复制

这句指令。

解决方案

编写并运行你的第一个Go语言“Hello World”程序，通常遵循以下几个简单的步骤：

创建项目目录（可选但推荐）：为了保持代码的组织性，我个人习惯为每个小项目或练习创建一个独立的文件夹。你可以在任意你喜欢的位置创建一个新目录，比如
```
~/go_projects/hello_world
```
登录后复制
。
创建Go源文件：在这个新创建的目录下，使用任何文本编辑器（如VS Code, Sublime Text, Vim, 或者GoLand等IDE）创建一个名为
```
main.go
```
登录后复制
的文件。文件名可以是任何你喜欢的，但
```
main.go
```
登录后复制
是一个常见的约定，尤其对于主程序入口。
编写代码：将以下代码复制并粘贴到你刚刚创建的
```
main.go
```
登录后复制
文件中：
```
package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}
```
登录后复制
保存文件。
运行程序：打开你的命令行终端（或PowerShell, CMD, iTerm等），导航到你创建
```
main.go
```
登录后复制
文件的目录。例如，如果你的文件在
```
~/go_projects/hello_world
```
登录后复制
，你可能需要输入
```
cd ~/go_projects/hello_world
```
登录后复制
。然后，执行以下命令：
```
go run main.go
```
登录后复制
你会在终端看到输出：

立即学习“go语言免费学习笔记（深入）”；
```
Hello, World!
```
登录后复制
这表明你的第一个Go程序已经成功运行了。

一个小提示： 除了
```
go run
```
登录后复制
，你也可以使用
```
go build
```
登录后复制
命令来编译你的程序。
```
go build main.go
```
登录后复制
这会在当前目录下生成一个可执行文件（在Windows上是
```
main.exe
```
登录后复制
，在Linux/macOS上是
```
main
```
登录后复制
）。然后你可以直接运行这个可执行文件：
```
./main  # macOS/Linux
main.exe # Windows
```
登录后复制
```
go run
```
登录后复制
在后台实际上是先编译后运行，但它不会留下编译后的文件，对于快速测试非常方便。而
```
go build
```
登录后复制
则会生成一个独立的二进制文件，方便部署和分发。我个人在开发初期更偏爱
```
go run
```
登录后复制
，因为它更简洁。

理解Go语言程序的基本构成与包管理

当我们写下第一个“Hello World”程序时，即使代码量很小，它也包含了Go语言程序最核心的几个概念。我记得我刚接触时，也曾好奇这些看似简单的结构背后有什么深意。

一览运营宝

一览“运营宝”是一款搭载AIGC的视频创作赋能及变现工具，由深耕视频行业18年的一览科技研发推出。

查看详情

首先是

package main

登录后复制

。在Go语言中，每个文件都必须属于一个包。

main

登录后复制

是一个特殊的包名，它告诉Go编译器，这个包是一个可执行程序，而不是一个库。一个Go程序，它的入口点必须是

package main

登录后复制

包下的

main

登录后复制

函数。如果你尝试编译一个没有

package main

登录后复制

或

main

登录后复制

函数的文件，Go编译器会报错，因为它不知道从哪里开始执行。这有点像告诉系统“嘿，从这里开始启动！”。

接着是

import "fmt"

登录后复制

。

import

登录后复制

语句用于导入其他包，以便在当前文件中使用这些包提供的功能。

fmt

登录后复制

是Go标准库中的一个包，它提供了格式化输入输出的功能，比如我们用来打印字符串的

fmt.Println()

登录后复制

。这个包名

fmt

登录后复制

实际上是“format”的缩写。Go语言的包管理设计得非常简洁，你不需要像其他语言那样写很长的路径，只需要包名即可，Go会自动在你的GOPATH或Go Modules中查找。我发现这种设计让代码看起来非常干净，避免了不必要的冗余。

最后是

func main() { ... }

登录后复制

。

func

登录后复制

关键字用于定义函数，

main

登录后复制

函数是程序的入口点。当Go程序运行时，它会首先执行

main

登录后复制

函数中的代码。括号

()

登录后复制

表示这个函数不接受任何参数，而花括号

{}

登录后复制

则定义了函数体的范围。

fmt.Println("Hello, World!")

登录后复制

则是调用

fmt

登录后复制

包中的

Println

登录后复制

函数，将字符串 "Hello, World!" 打印到标准输出，并在末尾自动添加一个换行符。这种设计使得即使是初学者也能很快理解程序的执行流程。

Go语言程序运行的几种方式与常见问题排查

除了

go run

登录后复制

和

go build

登录后复制

之外，其实还有一些更高级的运行方式，比如集成开发环境（IDE）如GoLand通常会提供一键运行/调试按钮，它们在后台也是调用

go run

登录后复制

或

go build

登录后复制

。了解这些运行机制，对于我们排查问题非常有帮助。

常见的运行方式：

go run [文件名]
登录后复制
：最简单直接的方式，适合开发和测试阶段。它会编译并运行指定文件，不会在磁盘上留下可执行文件。
go build [文件名或包路径]
登录后复制
：编译源代码生成可执行文件。如果你不指定文件名，它会尝试编译当前目录下的
```
main
```
登录后复制
包。例如，
```
go build .
```
登录后复制
会编译当前目录下的
```
main
```
登录后复制
包，并生成一个与当前目录同名的可执行文件。这在准备发布或分发程序时非常有用。
go install [包路径]
登录后复制
：编译并安装包到
```
GOPATH/bin
```
登录后复制
或
```
GOBIN
```
登录后复制
目录下。这通常用于安装可执行程序或库到系统路径，方便全局调用。

常见问题排查：

command not found: go
登录后复制
：这通常意味着你的Go环境没有正确安装，或者Go的可执行文件路径没有被添加到系统的PATH环境变量中。你需要检查Go的安装步骤，确保
```
$GOROOT/bin
```
登录后复制
（Go的安装路径下的bin目录）在你的PATH中。
no Go files in ...
登录后复制
：这个错误表明你在运行
```
go run
```
登录后复制
或
```
go build
```
登录后复制
命令时，当前目录下没有找到
```
.go
```
登录后复制
源代码文件，或者你指定的文件名有误。确保你在正确的目录，并且文件名拼写正确。
package main is not a main package
登录后复制
或
undefined: main
登录后复制
：这表示你的
```
.go
```
登录后复制
文件没有定义
```
package main
```
登录后复制
或
```
func main()
```
登录后复制
。记住，可执行程序必须有这两个元素作为入口。
编译错误（Syntax Error）： Go编译器会给出非常详细的错误信息，通常会指出错误的文件名、行号和列号。例如，如果你忘记了
```
fmt.Println
```
登录后复制
后面的括号，编译器会告诉你。仔细阅读错误信息是解决问题的第一步。我发现Go的错误提示通常都很友好，能直接指出问题所在，这比一些其他语言的错误信息要清晰得多。
unresolved import "fmt"
登录后复制
：这意味着Go编译器找不到
```
fmt
```
登录后复制
包。这在标准库中很少发生，但如果是你自己的自定义包或第三方包，可能是
```
go mod tidy
```
登录后复制
或
```
go get
```
登录后复制
没有正确运行，或者你的模块路径配置有问题。

从“Hello World”到Go语言的下一步学习路径

“Hello World”只是Go语言旅程的起点。接下来，我个人觉得有几个核心概念是值得深入学习的，它们会帮助你构建更复杂、更健壮的程序。

基本数据类型和变量： 了解Go语言支持的各种数据类型（整数、浮点数、布尔值、字符串等），以及如何声明和使用变量。Go的类型推断机制（
```
:=
```
登录后复制
）会让你写代码时感觉很方便，但理解显式类型声明（
```
var
```
登录后复制
）也是基础。
控制流： 掌握条件语句（
```
if/else
```
登录后复制
）、循环语句（
```
for
```
登录后复制
）和分支语句（
```
switch
```
登录后复制
）。Go语言的
```
for
```
登录后复制
循环非常强大，可以替代其他语言中的
```
while
```
登录后复制
循环。
函数： 函数是Go语言中的核心构建块。学习如何定义函数、传递参数、返回多个值，以及匿名函数和闭包的概念。Go语言多返回值的设计，尤其在错误处理上，是非常优雅且实用的。
切片（Slice）和映射（Map）： 这两种是Go语言中最常用的复合数据类型，它们提供了动态数组和键值对存储的能力。理解它们的底层实现和使用场景对于编写高效Go代码至关重要。
结构体（Struct）和方法（Method）： 结构体允许你组合不同类型的数据，而方法则允许你为结构体定义行为。这是实现面向对象编程思想（尽管Go不是传统意义上的OOP语言）的关键。
接口（Interface）： Go语言接口是其类型系统中最强大的特性之一，它实现了多态。理解接口的工作原理和如何设计良好的接口，是编写可扩展、可维护Go代码的关键。
并发编程（Goroutine和Channel）： 这是Go语言的“杀手级特性”。学习如何使用轻量级的协程（goroutine）和用于协程间通信的通道（channel）来编写高效的并发程序。这部分内容可能会有点挑战，但一旦掌握，你会发现Go在处理并发任务上有多么出色。