Go 文档 on 我的博客

Effective Go 学习笔记

Tue, 04 Aug 2026 00:00:00 +0000

Effective Go 学习笔记 #

本文档基于 Go 官方文档 Effective Go 整理编写。每个知识点配有可运行的示例代码，帮助理解和实践。

注意：Effective Go 最初编写于 2009 年（Go 发布时），未涵盖泛型（Generics）等后续新增的语言特性。如需了解最新变化，请参考 Go Release Notes。

1. 引言（Introduction） #

Effective Go 是学习编写地道 Go 代码的指南。Go 是一种注重简洁、可靠、高效的语言。要写好 Go 代码，需要理解其特性和惯用法——不能简单地把 C++ 或 Java 的写法翻译成 Go。

核心理念：Go 程序应该在结构、命名、格式等方面遵循社区约定，这样其他 Go 程序员能轻松理解你的代码。

示例：Go 的"从问题出发"思维 #

package main

import "fmt"

// 传统 OOP 风格（不推荐）
type Printer struct{}

func (p Printer) Print(s string) {
    fmt.Println(s)
}

// Go 风格：用函数/接口组合（推荐）
func Print(s string) {
    fmt.Println(s)
}

func main() {
    // Go 不推荐过度封装，简单的功能直接用函数
    Print("Hello, Effective Go!")
}

2. 格式（Formatting） #

Go 的格式由 gofmt（或 go fmt）自动处理。格式化问题交给机器，不再需要团队争论代码风格。

Go by Example 完整学习笔记

Tue, 04 Aug 2026 00:00:00 +0000

Go by Example 完整学习笔记 #

以下内容整理自 Go by Example 网站的 18 个页面的代码、说明和输出。

Structs #

Go 的 structs（结构体） 是类型化的字段集合，用于将数据组合成记录。

package main

import "fmt"

// person 结构体包含 name 和 age 字段
type person struct {
    name string
    age  int
}

// newPerson 用给定的名字构造一个新的 person 结构体
func newPerson(name string) *person {
    p := person{name: name}
    p.age = 42
    return &p
}

func main() {
    // 按位置顺序创建结构体
    fmt.Println(person{"Bob", 20})

    // 按字段名初始化
    fmt.Println(person{name: "Alice", age: 30})

    // 省略的字段为零值
    fmt.Println(person{name: "Fred"})

    // & 前缀生成结构体指针
    fmt.Println(&person{name: "Ann", age: 40})

    // 使用构造函数
    fmt.Println(newPerson("Jon"))

    // 用点号访问字段
    s := person{name: "Sean", age: 50}
    fmt.Println(s.name)

    // 结构体指针自动解引用
    sp := &s
    fmt.Println(sp.age)

    // 结构体是可变的
    sp.age = 51
    fmt.Println(sp.age)

    // 匿名结构体
    dog := struct {
        name   string
        isGood bool
    }{
        "Rex",
        true,
    }
    fmt.Println(dog)
}

运行输出：

Go 版本演进:从 1.0 到 1.26.5

Tue, 04 Aug 2026 00:00:00 +0000

Go 版本演进：从 1.0 到 1.26.5 的重大变化与特性 #

本文档梳理了 Go 语言从 2012 年 1.0 发布到 2026 年 1.26.5 的主要语言特性、标准库更新、工具链改进和性能提升，每个特性附简单代码示例。

参考来源：

Go Release History

Go 1.26 Release Notes

Go 1.25 Release Notes

Go features by version

Go 1.0（2012-03-28） #

Go 的第一个稳定版本。核心特性：

Go 1 兼容性承诺：后续版本保持向后兼容
标准库：net/http、encoding/json、template、crypto/tls 等
工具链：go get、go fmt、go test、go doc
并发模型：goroutine 和 channel

package main

import "fmt"

func main() {
    // goroutine 与 channel
    ch := make(chan string)
    go func() {
        ch <- "Hello, Go 1.0!"
    }()
    fmt.Println(<-ch)
}

Go 1.1（2013-05-13） #

竞态检测器（Race Detector） #

运行时检测数据竞争，在测试或运行程序时通过 -race 标志启用。

Go 标准库完全参考手册

Tue, 04 Aug 2026 00:00:00 +0000

Go 标准库完全参考手册 #

本文档基于 Go 1.26.5 标准库整理编写。涵盖所有公开标准库包的核心用法，每个功能配有代码示例和中文注释。示例来源：Go 官方文档 pkg.go.dev

fmt — 格式化输入输出 #

打印函数 #

fmt.Print — 默认格式输出
fmt.Printf — 格式化输出（占位符）
fmt.Println — 输出后换行
fmt.Sprint / Sprintf / Sprintln — 返回字符串而非打印
fmt.Fprint / Fprintf / Fprintln — 写入 io.Writer

常用占位符 #

占位符	含义	示例输出
`%v`	值的默认格式	`{7 -2.35}`
`%+v`	带字段名的结构体	`{a:7 b:-2.35}`
`%#v`	Go 语法表示	`main.T{a:7, b:-2.35}`
`%T`	值的类型	`main.T`
`%d`	十进制整数	`42`
`%s`	字符串	`"hello"`
`%q`	带引号字符串	`"hello"`
`%f`	浮点数	`3.141593`
`%.2f`	两位小数浮点数	`3.14`
`%t`	布尔值	`true`
`%x`	十六进制	`ff`

package main

import "fmt"

type Person struct {
    Name string
    Age  int
}

func main() {
    // Printf — 格式化输出
    fmt.Printf("Hello, %s!\n", "World")

    // %d — 整数占位符
    fmt.Printf("年龄: %d 岁\n", 25)

    // %v — 任意值的默认格式，适合快速打印
    fmt.Printf("值: %v\n", Person{"Alice", 30})

    // %+v — 结构体带字段名，调试时非常有用
    fmt.Printf("详细: %+v\n", Person{"Bob", 25})

    // %#v — 完整的 Go 语法表示，用于调试复杂类型
    fmt.Printf("Go语法: %#v\n", Person{"Charlie", 35})

    // %T — 打印类型，调试接口值时很常用
    var v interface{} = "hello"
    fmt.Printf("类型: %T\n", v)

    // %.2f — 控制浮点数精度
    fmt.Printf("圆周率: %.2f\n", 3.14159265)

    // Sprintf — 返回格式化字符串而非打印
    msg := fmt.Sprintf("结果: %d 条记录", 42)
    fmt.Println(msg)

    // Fprintf — 写入到 writer（如文件、HTTP 响应）
    // 下面的例子写入到标准错误
    fmt.Fprintf(stderr, "错误: 文件未找到\n")
}

// 模拟 stderr，实际使用 os.Stderr
var stderr = struct{ Write([]byte) (int, error) }{
    Write: func(p []byte) (int, error) {
        return len(p), nil
    },
}

官方文档：https://pkg.go.dev/fmt@go1.26.5

Go 大神技巧宝典(Go Guru Tips)

Tue, 04 Aug 2026 00:00:00 +0000

Go 大神技巧宝典（Go Guru Tips） #

汇集 Go 社区高手的实用技巧、妙招、心得与代码片段，适合日常开发反复参考。

覆盖：并发、语言特性、性能、错误处理、测试、标准库、工程实践、工具链八大主题，共 100+ 条技巧

适用 Go 版本：1.21+（示例尽量覆盖 1.22 循环变量语义、1.23 range over func 等新特性）

代码规范：优先仅用标准库，gofmt 格式，遵循 Effective Go，中文注释

来源：Go 官方博客（go.dev/blog）、Go Wiki、Effective Go、Dave Cheney / Rob Pike 等社区大神的博客与演讲、Stack Overflow 高赞回答、go101.org、煎鱼 / 李文周等中文资源

前言 #

这份文档不是教程，而是一本「按图索骥」的速查手册：当你在写代码时卡住、或想确认某段代码是否地道时，翻开对应章节即可。每一条技巧都遵循统一格式——一句话说明、为什么有用、可直接编译的代码示例、踩坑注意事项与来源链接。

建议：先通读一遍总目录记住「哪里有」，需要时再「深挖」具体条目。

总目录 #

一、并发与 Goroutine 技巧（12 条）
二、语言特性实用技巧（14 条）
三、性能优化与内存管理（12 条）
四、错误处理与日志（12 条）
五、测试与代码质量（12 条）
六、标准库实战妙用（13 条）
七、工程实践与项目管理（13 条）
八、调试与工具链（15 条）

一、并发与 Goroutine 技巧（Concurrency & Goroutines） #

一句话说明本主题：Go 并发编程的核心不是共享内存加锁，而是「通过通信共享内存」；本章收录 12 个高频、实用、可直接抄写的并发技巧，覆盖 channel 关闭原则、取消传播、扇出/扇入、工作池、errgroup、限流、防泄漏等日常工作最常遇到的场景。

Go 设计模式学习笔记(23 种 GoF 模式 × Go 惯用实现)

Tue, 04 Aug 2026 00:00:00 +0000

Go 设计模式学习笔记（23 种 GoF 模式 × Go 惯用实现） #

本笔记基于 Refactoring Guru（中文站）的经典 23 种 GoF 设计模式目录，用 Go 视角重新梳理。每个模式按「模式介绍 → 设计逻辑 → 应用场景 → 生产示例 → Go 简化 / 变体」展开，重点不是照搬经典类图，而是理解这些模式在 Go 中如何被简化、变体或替代，并学习 Go 社区基于语言特性（接口、组合、channel、函数一等公民）的惯用写法。所有代码均为可编译、可运行的独立示例，只用 Go 标准库，中文注释。

一、为什么 Go 需要重新审视设计模式 #

经典 GoF 模式诞生于 Java / C++ 时代，依赖继承、抽象类、protected、方法重载这些 OOP 机制。Go 刻意去掉了这些，换来的是更简单的语言：

Go 学习完整指南

Tue, 04 Aug 2026 00:00:00 +0000

Go 学习完整指南 #

本文档整合了 Go 官方学习资源 (go.dev/learn/) 和 Go by Example (gobyexample.com) 的全部内容，提供完整、可用、可重复学习的 Go 语言参考资料。

第一部分：Go 官方学习资源 #

1.1 Go 入门教程 (Getting Started) #

来源：https://go.dev/doc/tutorial/getting-started

本教程快速介绍 Go 编程基础，包括安装 Go、编写 “Hello, World”、使用 go 命令运行代码、调用外部模块函数。

前提条件 #

有一定的编程经验
代码编辑器（VSCode、GoLand、Vim 等）
命令行终端

安装 Go #

从 https://go.dev/dl 下载并安装最新版本（Go 1.26.5）。