Go 第一个工程：Hello World🧱
Go 第一个工程：Hello World
一、核心重点（快速掌握）
| 序号 | 重点内容 | 备注说明 |
|---|---|---|
| 1 | 安装并配置好 Go SDK 1.24 | 确保 go version 显示正确版本 |
| 2 | GoLand 正确安装与插件支持 | 使用 GoLand 创建项目自动配置 GOPROXY 和 GO111MODULE |
| 3 | 启用 Module 模式 | 默认启用，确保 go.mod 文件生成 |
| 4 | 编写标准 Hello World 程序 | 包含 main 函数和 fmt.Println 输出 |
| 5 | 成功运行与调试程序 | 支持 Run/Debug 按钮一键执行 |
| 6 | 掌握基本的命令行构建方式 | 如 go run, go build |
二、知识点详解（专题深入）
1. 安装 Go SDK（以 Go 1.24 为例）
✦ 知识点：
- Go SDK 是 Go 开发的基础环境。
- Windows 上推荐使用 MSI 安装包进行安装。
- 安装后会自动配置
GOROOT和将go命令加入系统 PATH。
✦ 实例：
访问 Go 官方下载页面 下载适用于 Windows 的 go1.24.windows-amd64.msi 安装包。
安装完成后，在 PowerShell 或 CMD 中输入：
go version
输出应为类似：
go version go1.24 windows/amd64
✦ 注意点：
- 不要手动修改系统 PATH 添加 Go 路径，除非你清楚自己在做什么。
- 如果已有多个 Go 版本，请确认当前使用的版本是否正确。
✦ 技巧：
- 使用
go env查看当前环境变量配置。 - 使用
scoop install go可快速安装（需先安装 Scoop）。
2. 配置 Go 环境变量（Module 模式为主）
✦ 知识点：
- Go 1.11+ 默认启用 Module 模式，无需设置 GOPATH。
- Module 模式下项目可独立管理依赖。
- 主要环境变量包括
GO111MODULE、GOPROXY等。
✦ 实例：
查看当前环境变量设置：
go env
输出中应包含：
GO111MODULE="on"
GOPROXY="https://proxy.golang.org,direct"
GOMODCACHE="C:\Users\用户名\go\pkg\mod"
若需要切换代理加速国内开发：
go env -w GOPROXY=https://goproxy.cn,direct
✦ 注意点：
- Windows 用户不要手动设置
GOPATH，除非有遗留项目需求。 - 不建议关闭 Module 模式（即
GO111MODULE=off），除非必要。
✦ 技巧：
- 在 GoLand 中可以自动识别并应用这些环境变量。
- 使用
go mod init自动生成模块文件。
3. 安装并配置 GoLand 2025.1.3 社区版
✦ 知识点：
- GoLand 是 JetBrains 提供的专业 Go IDE。
- 社区版支持完整 Go 开发功能，包括代码提示、重构、调试等。
- 自动集成 Go Module 支持。
✦ 实例：
前往 JetBrains 官网 下载 GoLand 2025.1.3 安装包。
安装完成后打开，首次启动时选择：
- Do not import settings（如是首次使用）
- 选择 UI 主题（默认 Light/Dark）
- 安装 Golang 插件（已内置，无需额外安装）
创建新项目时选择：
- Go Modules (vgo) 模式
- 输入模块名称（例如：
example.com/hello）
✦ 注意点：
- 确保 GoLand 设置中的 Go SDK 路径正确指向 Go 1.24 安装目录。
- 若无法识别 SDK，可在 Settings → Go → GOROOT 中手动设置。
✦ 技巧：
- 使用快捷键
Ctrl + Shift + A快速搜索命令（如 Build、Run）。 - 配置 Live Template 快速生成常用代码片段（如
main函数）。
4. 创建并运行第一个 Go 工程：Hello World
✦ 知识点：
- Go 程序入口必须是
main函数。 - 程序结构简单清晰，适合初学者理解。
- GoLand 提供图形化 Run / Debug 按钮，方便执行。
✦ 实例：
步骤 1：创建项目
在 GoLand 中选择：
- New Project
- Go Modules (vgo)
- Module name:
example.com/hello - Location: 选择本地路径（如
D:\workspace\hello）
点击 Create。
步骤 2：创建源文件
右键 hello 目录 → New → File → 输入 main.go
输入以下代码：
package main
import "fmt"
func main() {
fmt.Println("Hello, World!")
}
步骤 3：运行程序
点击编辑器左上角绿色 ▶️ Run 按钮，或使用快捷键 Shift + F10
输出结果：
Hello, World!
步骤 4：构建可执行文件
在终端执行：
go build -o hello.exe
然后运行：
.\hello.exe
输出相同结果。
✦ 注意点：
main.go必须位于项目根目录或子包中。main函数必须无参数、无返回值。- 不要在
main函数中调用其他复杂逻辑，保持简洁。
✦ 技巧：
- 使用
Ctrl + Alt + L格式化代码。 - 使用
Ctrl + /注释选中代码。 - 使用
Run Anything功能运行任意命令（快捷键Double Shift）。
5. 常见问题排查
| 问题描述 | 解决方案 |
|---|---|
cannot find package 错误 |
检查 go.mod 是否存在，尝试 go mod tidy |
undefined: fmt |
检查 import 是否正确，注意双引号 |
| GoLand 无法识别 SDK | 进入 Settings → Go → 设置正确的 GOROOT |
构建失败提示 no Go files |
检查文件名是否为 .go，且位于正确目录 |
go: command not found |
确保 Go 已安装并加入系统 PATH |
could not determine target OS/architecture |
更新 GoLand 至最新版，或重新加载模块 |
小结
完成第一个 Hello World 工程是学习 Go 的第一步。通过在 Windows 平台上使用 GoLand 2025.1.3 和 Go SDK 1.24，我们成功搭建了开发环境，并完成了基础项目的创建、运行和构建。
学习建议：
- 熟练掌握 GoLand 的基本操作（新建文件、运行、格式化、查找命令）
- 练习使用
go run和go build命令- 理解 Go Module 模式的项目结构
- 学会在终端和 IDE 中切换执行方式
- 熟悉常见错误的解决方法
下一步可继续学习《Go 基础语法入门》，逐步掌握变量、控制语句、函数、结构体等内容。
浙公网安备 33010602011771号