WEEW12 BLOG

外观

《Go Cookbook CN》系列 01：Go环境搭建与基础编程全解

约 2809 字大约 9 分钟

《Go Cookbook CN》系列Go语言

2026-04-02

本文聚焦Go语言入门核心内容，从环境搭建到基础编程实操，手把手带你掌握Go语言的安装配置、在线运行环境使用、Hello World程序编写、第三方包调用、错误处理、日志记录及单元测试的全流程，学完即可独立完成Go语言基础程序的编写与验证。

【本篇核心收获】

  • 掌握Go语言在macOS、Linux、Windows系统的安装方法，以及从源码构建的实操步骤，能独立验证安装结果
  • 学会使用Go Playground在线运行Go代码，无需本地环境即可快速验证简单程序
  • 熟练编写Go语言Hello World程序，理解包、入口函数的核心概念，掌握编译与运行的两种方式
  • 掌握Go Modules管理第三方依赖的方法，能导入并使用外部软件包解决实际问题
  • 理解Go语言错误处理的核心逻辑，掌握日志记录与单元测试的基础实操方法

2.1 Go语言简介

Go语言入门阶段需掌握基础编程方法，涵盖环境安装、简单代码编写、外部库使用、错误处理、基础测试及日志记录等核心内容。本章节示例以简洁为主，后续章节会展开详解；若已掌握Go基础，可直接跳过本章。

模块小结：本模块明确了本章的核心学习范围，定位为Go语言入门基础，覆盖从环境到基础编程的全流程核心知识点。

2.2 Go环境安装与验证

2.2.1 安装方式总览

安装Go语言主要有三种方式：下载官方预构建二进制文件（推荐）、使用操作系统包管理器、从源代码编译。除非无适配的预构建二进制文件，否则无需从源码编译。

2.2.2 各系统安装步骤

macOS

  1. 方式一（官方安装包）：

    • 打开下载的 .pkg 安装包，按提示安装，Go默认安装在 /usr/local/go 目录。
    • 需将 /usr/local/go/bin 添加到环境变量 PATH 中。

  2. 方式二（Homebrew）：

    • 终端运行命令更新并安装：
    brew update && brew install golang
    • 安装完成后，按提示将Go的二进制目录添加到 PATH 环境变量。

Linux

  1. 解压下载的压缩包到 /usr/local 目录（替换版本号为实际下载版本）：

    sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.20.1-linux-amd64.tar.gz

  2. 将 /usr/local/go/bin 添加到 PATH 环境变量：

    • 编辑 $HOME/.profile 文件，在末尾添加：

      export PATH=$PATH:/usr/local/go/bin

    • 下次登录生效，若需立即生效，运行：

      source $HOME/.profile

Windows

  1. 打开下载的MSI安装程序，按提示安装。
  2. 默认安装路径为Program Files或Program Files (x86)，可在安装过程中修改。

2.2.3 从源码构建

仅当无适配的预构建二进制文件时推荐使用，步骤如下：

  1. 将源码解压到合适目录，进入src目录。

  2. 执行构建脚本：

    • Linux/macOS：

      cd src && ./all.bash

    • Windows：运行 all.bat（需提前安装编译工具链）。

  3. 构建成功后会输出类似内容：

    ALL TESTS PASSED
---
Installed Go for linux/amd64 in /home/you/go.
Installed commands in /home/you/go/bin.
***You need to add /home/you/go/bin to your $PATH.***

2.2.4 安装验证

运行以下命令查看Go版本，验证安装是否成功：

go version

安装正确时，输出示例：

go version go1.20.1 darwin/amd64

模块小结：本模块完整覆盖了Go语言在主流系统的安装方法、源码构建步骤及安装验证方式，核心是通过预构建二进制文件快速完成环境搭建，并掌握环境变量配置与验证方法。

2.3 Go Playground：无环境运行Go代码

2.3.1 核心价值

无需下载安装Go，即可在沙箱环境中编写并运行Go程序，适合快速验证简单代码。

2.3.2 使用方法

  1. 浏览器打开链接：https://go.dev/play/。
  2. 在线环境支持最新版本Go，也可切换历史版本，代码的标准输出/错误会显示在网页中，如下图所示：

图1：Go Playground在线运行界面

模块小结：本模块介绍了Go Playground的使用场景与操作方法，是无本地环境时快速编写、运行Go代码的核心工具。

2.4 编写Hello World程序

2.4.1 核心代码解析

创建hello.go文件（建议放在单独目录如hello），代码如下：

package main

import "fmt"

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

核心概念解析：

  • package main：定义文件所属包名，main包是特殊包，编译后生成可执行程序；同一包内的.go文件需在同一目录。
  • import "fmt"：导入标准库的fmt包，用于格式化输入输出。
  • main函数：可执行程序的入口点，程序从该函数开始执行。

Go标准库功能丰富，可访问https://pkg.go.dev/std了解详情。

2.4.2 运行与编译方式

直接运行

进入hello.go所在目录，运行：

go run hello.go

正常输出：

Hello, World!

编译为可执行文件

  1. 基础编译：

    go build hello.go

    生成可执行文件（macOS/Linux为hello，Windows为hello.exe）。

  2. 指定输出文件名：

    go build -o helloworld

    生成helloworld（或helloworld.exe）可执行文件。

模块小结：本模块通过Hello World程序讲解了Go语言的核心基础概念（包、入口函数），以及程序运行与编译的两种核心方式，是入门Go编程的核心起点。

2.5 使用外部软件包

2.5.1 第三方包导入语法

以github.com/dustin/go-humanize（格式化文件大小）为例，导入与使用方式如下：

  1. 基础导入：

    package main

import (
    "fmt"
    "github.com/dustin/go-humanize"
)

func main() {
    var number uint64 = 123456789
    fmt.Println("Size of file is", humanize.Bytes(number))
}

  2. 包别名（解决冲突/简化调用）：

    package main

import (
    "fmt"
    human "github.com/dustin/go-humanize"
)

func main() {
    var number uint64 = 123456789
    fmt.Println("Size of file is", human.Bytes(number))
}

注：导入路径最后一段通常是包名，但并非绝对，别名可避免同名包冲突。

2.5.2 Go Modules依赖管理

直接运行含第三方包的代码会报错（示例：go run human.go）：

human.go:6:2: no required module provides package github.com/dustin/go-humanize: go.mod file not found in the current directory or any parent directory; see 'go help modules'

需通过Go Modules管理依赖，步骤如下：

  1. 初始化模块（创建go.mod文件）：

    go mod init example/human

  2. 下载依赖包：

    go get github.com/dustin/go-humanize

  3. 清理未使用依赖：

    go mod tidy

避坑指南：Go Modules是管理第三方依赖的核心工具，未初始化模块时无法直接使用外部包，需先完成go mod init操作。

模块小结：本模块讲解了第三方包的导入语法（含别名），以及Go Modules管理依赖的核心步骤，解决了外部包使用的核心问题。

2.6 错误处理

2.6.1 核心逻辑

Go语言约定：可能出错的函数会返回“结果值+error类型错误”，需显式检查错误值。

2.6.2 实操示例

以strconv.ParseInt（字符串转整数）为例：

package main

import (
    "fmt"
    "strconv"
)

func main() {
    str := "123456789"
    num, err := strconv.ParseInt(str, 10, 64)
    if err != nil {
        panic(err) // 出错则终止程序
    }
    fmt.Println("Number is", num)
}

  • 正常运行输出：Number is 123456789。

  • 若str改为"abcdefg"，触发panic：

    panic: strconv.ParseInt: parsing "abcdefg": invalid syntax
goroutine 1 [running]:
main.main()
        /path/to/file/main.go:10 +0xae
exit status 2

注：错误处理方式可灵活选择（记录日志、返回错误、重试等），panic仅为快速终止程序的方式。

模块小结：本模块核心是掌握Go语言“显式检查error”的错误处理逻辑，理解函数返回值的设计约定，以及基础的错误响应方式。

2.7 记录事件（日志）

2.7.1 核心工具

使用Go标准库log包记录日志，可追踪程序运行状态、诊断问题。

2.7.2 实操示例

package main

import (
    "fmt"
    "log"
    "strconv"
)

func main() {
    str := "123456789"
    num, err := strconv.ParseInt(str, 10, 64)
    if err != nil {
        log.Fatal("Cannot parse string:", err) // 记录日志并退出
    }
    fmt.Println("Number is", num)
}

  • 错误时输出示例（带时间戳）：

    2021/11/18 09:19:35 Cannot parse string: strconv.ParseInt: parsing "abcdefg": invalid syntax
exit status 1

  • 日志默认输出到标准错误，也可重定向到文件或多目标（进阶用法后续详解）。

模块小结：本模块介绍了log包的基础使用方法，核心是通过日志记录关键事件，log.Fatal可同时完成日志输出与程序终止，是基础的错误日志处理方式。

2.8 代码测试

2.8.1 测试文件编写规范

  1. 提取待测试逻辑（示例：字符串转整数）：

    package main

import "strconv"

func main() {
    // 主函数留空或用于调用测试
}

// conv 函数将字符串转换为十进制整数
func conv(str string) (num int64, err error) {
    num, err = strconv.ParseInt(str, 10, 64)
    return
}

  2. 创建测试文件（命名规则：_test.go结尾，如conv_test.go）：

    package main

import "testing"

func TestConv(t *testing.T) {
    num, err := conv("123456789")
    if err != nil {
        t.Fatal(err) // 测试失败，记录错误
    }
    if num != 123456789 {
        t.Fatal("Number doesn't match")
    }
}

func TestFailConv(t *testing.T) {
    _, err := conv("")
    if err == nil {
        t.Fatal("Expected an error but got none")
    }
}

编写规则：

  • 测试函数以Test开头，接收*testing.T参数。
  • 调用被测试函数，检查返回值是否符合预期，不符合则用t.Fatal标记失败。

2.8.2 测试运行与结果验证

  1. 运行测试（-v查看详细输出）：

    go test -v

  2. 正常输出（所有测试通过）：

    === RUN   TestConv
--- PASS: TestConv (0.00s)
=== RUN   TestFailConv
--- PASS: TestFailConv (0.00s)
PASS
ok      github.com/example/project    0.001s

  3. 错误示例（修改conv函数进制为2）：

    func conv(str string) (num int64, err error) {
    num, err = strconv.ParseInt(str, 2, 64) // 错误使用二进制解析
    return
}

    测试输出：

    === RUN   TestConv
    conv_test.go:8: strconv.ParseInt: parsing "123456789": invalid syntax
--- FAIL: TestConv (0.00s)
=== RUN   TestFailConv
--- PASS: TestFailConv (0.00s)
FAIL
exit status 1
FAIL    github.com/example/project    0.001s

模块小结：本模块讲解了Go内置测试框架的使用方法，核心是遵循测试文件命名、函数编写规范，通过go test运行测试并验证结果，是保障代码功能符合预期的核心手段。

【本篇核心知识点速记】

  1. 环境搭建：主流系统优先使用预构建二进制文件安装，需配置PATH环境变量，通过go version验证安装；源码构建仅作为兜底方案。
  2. 在线运行：Go Playground（https://go.dev/play/）可无环境快速运行Go代码，适合验证简单逻辑。
  3. 基础编程：main包+main函数是可执行程序的核心，go run直接运行代码，go build编译为可执行文件。
  4. 第三方包：导入需写完整仓库路径，通过Go Modules（go mod init/go get）管理依赖，别名可解决包名冲突。
  5. 错误处理：显式检查error类型返回值，panic为快速终止程序的方式，可根据场景选择日志、重试等处理方式。
  6. 日志记录：log包可记录带时间戳的日志，log.Fatal兼具日志输出与程序终止功能。
  7. 单元测试：测试文件以_test.go结尾，测试函数以Test开头，通过go test运行，验证函数返回值是否符合预期。

Copyright © 2026 weew12