来源书籍

Effective Go中文版

Skill 版本:v23 编程语言类 80 张卡片

看云文档小组 · 看云 · 2015-10-21

类别清单覆盖

6/9

已覆盖 6 补充生成 0 未覆盖 3

章节与卡片

01 简介

2 张卡片
  1. 用Go的方式设计程序 理解等级:高级 普通读书笔记卡
  2. 标准库源码也是使用范例 理解等级:中级 普通读书笔记卡

02 格式

2 张卡片
  1. 用gofmt统一格式 理解等级:中级 普通读书笔记卡
  2. Go布局遵循语法和工具 理解等级:初级 普通读书笔记卡

03 注释

3 张卡片
  1. 声明前注释生成文档 理解等级:中级 普通读书笔记卡
  2. 包注释界定整体职责 理解等级:中级 普通读书笔记卡
  3. 导出声明注释以名字起句 理解等级:中级 普通读书笔记卡

04 名字

6 张卡片
  1. 首字母决定跨包可见性 理解等级:初级 普通读书笔记卡
  2. 包名应简短且便于引用 理解等级:中级 普通读书笔记卡
  3. 导出名避免重复包名 理解等级:中级 普通读书笔记卡
  4. 读取方法不必加Get 理解等级:初级 普通读书笔记卡
  5. 接口名应表达行为 理解等级:中级 普通读书笔记卡
  6. 多词标识符使用混合大小写 理解等级:初级 普通读书笔记卡

05 分号

1 张卡片
  1. 换行触发分号插入 理解等级:中级 普通读书笔记卡

06 控制结构

7 张卡片
  1. 提前返回让主流程直行 理解等级:中级 普通读书笔记卡
  2. 短声明可复用同域变量 理解等级:中级 普通读书笔记卡
  3. for统一循环形式 理解等级:初级 普通读书笔记卡
  4. 字符串range按码点迭代 理解等级:中级 普通读书笔记卡
  5. switch可按条件顺序匹配 理解等级:中级 普通读书笔记卡
  6. 标号控制外层循环 理解等级:中级 普通读书笔记卡
  7. 类型switch按动态类型分支 理解等级:中级 普通读书笔记卡

07 函数

4 张卡片
  1. 多返回值同时报告结果与错误 理解等级:中级 普通读书笔记卡
  2. 命名结果是函数内变量 理解等级:中级 普通读书笔记卡
  3. defer绑定函数退出时清理 理解等级:中级 普通读书笔记卡
  4. defer参数先求值后逆序调用 理解等级:中级 普通读书笔记卡

08 数据

20 张卡片
  1. new返回零值指针 理解等级:初级 普通读书笔记卡
  2. 零值可用能组合传递 理解等级:中级 普通读书笔记卡
  3. 复合字面量按字段构造 理解等级:中级 普通读书笔记卡
  4. 返回局部变量地址仍有效 理解等级:初级 普通读书笔记卡
  5. make初始化三类引用值 理解等级:中级 普通读书笔记卡
  6. 数组赋值会复制全部元素 理解等级:中级 普通读书笔记卡
  7. 切片共享底层数组 理解等级:中级 普通读书笔记卡
  8. 扩容后须接收新切片 理解等级:中级 普通读书笔记卡
  9. 二维切片按行变化选内存布局 理解等级:高级 普通读书笔记卡
  10. map键需要可比较 理解等级:初级 普通读书笔记卡
  11. comma-ok区分缺项与零值 理解等级:中级 普通读书笔记卡
  12. delete可安全删除不存在键 理解等级:初级 普通读书笔记卡
  13. bool映射可表达集合 理解等级:初级 普通读书笔记卡
  14. fmt格式化由类型与动词决定 理解等级:中级 普通读书笔记卡
  15. String方法控制默认显示 理解等级:中级 普通读书笔记卡
  16. String中打印自身会递归 理解等级:高级 普通读书笔记卡
  17. 省略号转发可变参数 理解等级:中级 普通读书笔记卡
  18. append返回更新后的切片 理解等级:中级 普通读书笔记卡
  19. append依赖编译器内建支持 理解等级:中级 普通读书笔记卡
  20. map传递共享底层数据 理解等级:中级 普通读书笔记卡

09 初始化

3 张卡片
  1. 常量表达式在编译时求值 理解等级:初级 普通读书笔记卡
  2. iota可生成规律常量 理解等级:中级 普通读书笔记卡
  3. init在包变量初始化后执行 理解等级:中级 普通读书笔记卡

10 方法

3 张卡片
  1. 命名类型不限结构体也可有方法 理解等级:初级 普通读书笔记卡
  2. 指针接收者可更新切片头 理解等级:中级 普通读书笔记卡
  3. 指针方法决定接口实现 理解等级:中级 普通读书笔记卡

11 接口和其它类型

6 张卡片
  1. 接口按行为组合类型 理解等级:中级 普通读书笔记卡
  2. 类型转换可复用已有方法 理解等级:中级 普通读书笔记卡
  3. 类型断言用ok安全测试 理解等级:中级 普通读书笔记卡
  4. 接口公开行为隐藏实现 理解等级:高级 普通读书笔记卡
  5. 接口让块密码组合为流 理解等级:高级 结构图卡
  6. HandlerFunc适配器 理解等级:中级 结构图卡

12 空白标识符

4 张卡片
  1. 空白标识符丢弃不需要的值 理解等级:初级 普通读书笔记卡
  2. 临时占位应标明待删除 理解等级:中级 普通读书笔记卡
  3. 匿名导入只保留初始化副作用 理解等级:中级 普通读书笔记卡
  4. 空白赋值强制检查接口实现 理解等级:中级 普通读书笔记卡

13 内嵌(Embedding)

4 张卡片
  1. 接口内嵌组合方法集 理解等级:中级 普通读书笔记卡
  2. 结构体内嵌提升方法 理解等级:中级 普通读书笔记卡
  3. 内嵌方法仍使用内部接收者 理解等级:高级 普通读书笔记卡
  4. 显式字段可遮蔽内嵌成员 理解等级:高级 普通读书笔记卡

14 并发

8 张卡片
  1. 用通信约束共享数据 理解等级:高级 普通读书笔记卡
  2. goroutine是轻量任务 理解等级:中级 普通读书笔记卡
  3. 无缓冲channel同步收发 理解等级:中级 普通读书笔记卡
  4. 缓冲channel容量限制并发 理解等级:高级 普通读书笔记卡
  5. 循环变量捕获取决于版本 理解等级:高级 普通读书笔记卡
  6. 请求内置响应channel 理解等级:中级 普通读书笔记卡
  7. 并发结构不同于并行执行 理解等级:中级 普通读书笔记卡
  8. 用缓冲channel复用对象 理解等级:中级 普通读书笔记卡

15 错误

5 张卡片
  1. 错误作为返回值传递 理解等级:初级 普通读书笔记卡
  2. 具体错误类型保留上下文 理解等级:中级 普通读书笔记卡
  3. 严重故障才考虑panic 理解等级:高级 普通读书笔记卡
  4. recover限定在延迟函数中 理解等级:中级 普通读书笔记卡
  5. 内部panic可转为公开错误 理解等级:高级 普通读书笔记卡

16 一个web服务示例

2 张卡片
  1. 模板按数据条件渲染页面 理解等级:中级 普通读书笔记卡
  2. 本地界面可包装外部服务 理解等级:中级 普通读书笔记卡

全书概览

Effective Go中文版

  • Skill 版本:v12
  • 本次执行版本:book-notes v23 / book-workflow v4(2026-10-23)
  • 执行模式:light
  • 建档进度:done
  • 本次复核说明:未执行笔记复核、独立审查及审查结果优化;历史审查报告保留,不作为新版笔记的审查证明。
  • 类别:编程语言类
  • 评级:工程实践(信息浓度高、稳定性低)
  • 评级理由:书中解释了 new 与 make 的语义差异、切片与底层数组的关系、channel 的同步行为及错误返回与 panic 的边界,信息不只是语法清单。原版与译本形成于 2015 年,含具体标准库调用、Web 服务地址和代码示例,实践前须核对现行环境。
  • 原书与版本:看云文档小组,2015 年 EPUB;原始输入和正文版本见 _source_manifest.json 与 _coverage.md。

章节进度追踪表

章节号 章节标题 状态(pending/done) 卡片数
01 简介 done 2
02 格式 done 2
03 注释 done 3
04 名字 done 6
05 分号 done 1
06 控制结构 done 7
07 函数 done 4
08 数据 done 20
09 初始化 done 3
10 方法 done 3
11 接口和其它类型 done 6
12 空白标识符 done 4
13 内嵌(Embedding) done 4
14 并发 done 8
15 错误 done 5
16 一个web服务示例 done 2

非正文排除

spine项 类型 排除理由
ref_cover / OEBPS/CoverPage.xhtml 封面 仅有封面图文字,无实质论述。
chapter17 / OEBPS/中文译者.md.html 译者名单 仅列译者姓名和联络信息,无实质正文。

整书笔记

连续阅读整书笔记:全书主线、16 章讲解、跨章联系与实践入口。整书笔记 SHA-256:f109d32ecf2ee2b1677a6209cc2ba767d7cdd2e72a51902998c0654ffaef62a2。采用 schema 1,登记 80 个 primary 位置和至少 80 处原书出处;来源项目及字节哈希见笔记元数据与 _workflow-v23/source-validation.json。

原全书与章节大纲保存在 _workflow-v23/overview-before-v23.md,本次不再重复维护阅读正文。

待关联术语

术语名 出现章节 一句话语境
CSP(通信顺序进程) 14 并发模型的思想来源,仅作管道类比,未展开形式化模型。

引用文献

| 标题 | 类型(书/论文/框架/源码项目) | 出现章节 | 一句话语境 | | — | — | — | | Go language specification | 规范 | 01 | 原文建议先读规范,再把本文作为扩展阅读;本节未展开规范内容。 | | Tour of Go | 教程 | 01 | 原文列为前置阅读资料;本节未展开教程内容。 | | How to Write Go Code | 教程 | 01 | 原文列为前置阅读资料;本节未展开其内容。 |

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
001 梳理Cardbox错误链 真实任务 done 15 实践计划;错误流转表尚未执行
002 对照Cardbox服务入口 真实任务 done 11、16 实践计划;请求链图与对照表尚未执行

实践候选筛选:done

候选筛选说明:选取本仓库可访问的 Go 代码作为真实对象,只规划阅读与核验;未采用“重写一套 Web 服务”或执行实践卡的现实行动。书中外部二维码服务地址具有时效性,不以它作为实践依赖。

类别清单核对(历史记录,非本次复核)

按“编程语言类”九项必答清单,将现有知识卡与原文定向检索结果对照;“已覆盖”只表示本书有实质讲解,不表示覆盖该维度全部子主题。

维度 覆盖状态(已覆盖/补充生成/未覆盖) 关联卡片标题或未覆盖理由
类型系统 已覆盖 [[接口按行为组合类型]]、[[接口内嵌组合方法集]]、[[类型断言用ok安全测试]];本书未讲泛型实现。
内存管理模型 未覆盖 [[new返回零值指针]]、[[make初始化三类引用值]]仅讲分配入口和零值;原文未实质说明 GC 策略、所有权或手动管理取舍。
并发/并行模型 已覆盖 [[goroutine是轻量任务]]、[[无缓冲channel同步收发]]、[[并发结构不同于并行执行]];内存模型仅有一处引用,未系统展开。
错误处理机制 已覆盖 [[错误作为返回值传递]]、[[严重故障才考虑panic]]、[[recover限定在延迟函数中]]。
编译/执行模型 未覆盖 原文提及编译器检查和运行时调度,但未实质比较编译、解释、JIT 或字节码模型。
模块/包与命名空间设计 已覆盖 [[首字母决定跨包可见性]]、[[包注释界定整体职责]]、[[导出名避免重复包名]];未讨论现代模块管理。
语言设计哲学与取舍 已覆盖 [[用Go的方式设计程序]]、[[用gofmt统一格式]]、[[用通信约束共享数据]]。
元编程/反射/宏能力 未覆盖 对正文定向检索未见反射、宏等机制的实质介绍,不能由接口或模板自行推演。
性能特性与其代价 已覆盖 [[扩容后须接收新切片]]、[[缓冲channel容量限制并发]]、[[用缓冲channel复用对象]],涉及分配和资源边界;未系统讲零成本抽象。

主题索引维护

已校验当前 notes/_topics/ 全部文件的 front matter、成员格式、唯一性及成员引用;本表已对 80 张卡逐卡核对;复用现有主题时按语义范围加入成员,未找到精确主题的卡保留“无需加入”。

卡片标题 结论(已复用/已创建/无需加入/待复核) 主题文件或原因
用Go的方式设计程序 已复用 notes/_topics/language-subset-discipline.md
标准库源码也是使用范例 无需加入 学习入口,不与现有主题的比较范围直接重合
用gofmt统一格式 已复用 notes/_topics/code-readability.md
Go布局遵循语法和工具 已复用 notes/_topics/code-readability.md
声明前注释生成文档 已复用 notes/_topics/code-readability.md
包注释界定整体职责 已复用 notes/_topics/code-readability.md
导出声明注释以名字起句 已复用 notes/_topics/code-readability.md
首字母决定跨包可见性 已复用 notes/_topics/interface-contracts-declarations.md
包名应简短且便于引用 已复用 notes/_topics/code-readability.md
导出名避免重复包名 已复用 notes/_topics/code-readability.md
读取方法不必加Get 已复用 notes/_topics/code-readability.md
接口名应表达行为 已复用 notes/_topics/interface-design-dispatch.md
多词标识符使用混合大小写 已复用 notes/_topics/code-readability.md
换行触发分号插入 已复用 notes/_topics/language-subset-discipline.md
提前返回让主流程直行 已复用 notes/_topics/code-readability.md
短声明可复用同域变量 无需加入 局部语法规则,无精确现有主题
for统一循环形式 无需加入 局部语法形式,无精确现有主题
字符串range按码点迭代 无需加入 字符遍历语义,不等同于内置结构底层实现主题
switch可按条件顺序匹配 无需加入 局部控制结构语义,无精确现有主题
标号控制外层循环 无需加入 局部控制结构语义,无精确现有主题
类型switch按动态类型分支 已复用 notes/_topics/interface-design-dispatch.md
多返回值同时报告结果与错误 已复用 notes/_topics/error-handling-mechanisms.md
命名结果是函数内变量 无需加入 局部函数语义,无精确现有主题
defer绑定函数退出时清理 已复用 notes/_topics/resource-ownership-lifetime.md
defer参数先求值后逆序调用 已复用 notes/_topics/resource-ownership-lifetime.md
new返回零值指针 无需加入 new 的局部零值分配语义,不属于现有分配器设计主题
零值可用能组合传递 已复用 notes/_topics/correct-by-construction.md
复合字面量按字段构造 无需加入 复合字面量的局部语法形式,无精确现有主题
返回局部变量地址仍有效 已复用 notes/_topics/resource-ownership-lifetime.md
make初始化三类引用值 已复用 notes/_topics/builtin-data-structure-internals.md
数组赋值会复制全部元素 已复用 notes/_topics/builtin-data-structure-internals.md
切片共享底层数组 已复用 notes/_topics/builtin-data-structure-internals.md
扩容后须接收新切片 已复用 notes/_topics/builtin-data-structure-internals.md
二维切片按行变化选内存布局 已复用 notes/_topics/builtin-data-structure-internals.md
map键需要可比较 已复用 notes/_topics/builtin-data-structure-internals.md
map传递共享底层数据 已复用 notes/_topics/builtin-data-structure-internals.md
comma-ok区分缺项与零值 已复用 notes/_topics/builtin-data-structure-internals.md
delete可安全删除不存在键 已复用 notes/_topics/builtin-data-structure-internals.md
bool映射可表达集合 已复用 notes/_topics/builtin-data-structure-internals.md
fmt格式化由类型与动词决定 无需加入 fmt 动词速查,不属于现有主题的比较范围
String方法控制默认显示 无需加入 String 默认显示约定,无精确现有主题
String中打印自身会递归 无需加入 格式化递归的局部易错点,无精确现有主题
省略号转发可变参数 无需加入 可变参数展开语法,无精确现有主题
append返回更新后的切片 已复用 notes/_topics/builtin-data-structure-internals.md
append依赖编译器内建支持 无需加入 内建 append 的语言签名特例,不属于编译器优化主题
常量表达式在编译时求值 无需加入 常量求值语义,不属于编译器优化主题
iota可生成规律常量 无需加入 iota 常量声明规则,无精确现有主题
init在包变量初始化后执行 无需加入 包初始化顺序与副作用,无精确现有主题
命名类型不限结构体也可有方法 已复用 notes/_topics/programming-paradigm-design.md
指针接收者可更新切片头 已复用 notes/_topics/interface-design-dispatch.md
指针方法决定接口实现 已复用 notes/_topics/interface-design-dispatch.md
接口按行为组合类型 已复用 notes/_topics/interface-design-dispatch.md
类型转换可复用已有方法 已复用 notes/_topics/interface-design-dispatch.md
类型断言用ok安全测试 已复用 notes/_topics/interface-design-dispatch.md
接口公开行为隐藏实现 已复用 notes/_topics/interface-design-dispatch.md
接口让块密码组合为流 已复用 notes/_topics/stream-processing-backpressure.md
HandlerFunc适配器 已复用 notes/_topics/interface-design-dispatch.md
空白标识符丢弃不需要的值 无需加入 空白标识符的局部赋值语义,无精确现有主题
临时占位应标明待删除 已复用 notes/_topics/language-subset-discipline.md
匿名导入只保留初始化副作用 无需加入 匿名导入的包初始化副作用,无精确现有主题
空白赋值强制检查接口实现 已复用 notes/_topics/correct-by-construction.md
接口内嵌组合方法集 已复用 notes/_topics/interface-design-dispatch.md
结构体内嵌提升方法 已复用 notes/_topics/interface-design-dispatch.md
内嵌方法仍使用内部接收者 已复用 notes/_topics/interface-design-dispatch.md
显式字段可遮蔽内嵌成员 已复用 notes/_topics/interface-design-dispatch.md
用通信约束共享数据 已复用 notes/_topics/concurrency-tasks-sync.md
goroutine是轻量任务 已复用 notes/_topics/goroutine-scheduling.md
无缓冲channel同步收发 已复用 notes/_topics/concurrency-tasks-sync.md
缓冲channel容量限制并发 已复用 notes/_topics/thread-pool-capacity-overload.md
循环变量捕获取决于版本 已复用 notes/_topics/language-subset-discipline.md
请求内置响应channel 已复用 notes/_topics/concurrency-tasks-sync.md
并发结构不同于并行执行 已复用 notes/_topics/concurrency-tasks-sync.md
用缓冲channel复用对象 无需加入 缓冲对象池示例不等同于现有分配器或并发容器主题
错误作为返回值传递 已复用 notes/_topics/error-handling-mechanisms.md
具体错误类型保留上下文 已复用 notes/_topics/error-handling-mechanisms.md
严重故障才考虑panic 已复用 notes/_topics/error-handling-mechanisms.md
recover限定在延迟函数中 已复用 notes/_topics/error-handling-mechanisms.md
内部panic可转为公开错误 已复用 notes/_topics/error-handling-mechanisms.md
模板按数据条件渲染页面 已复用 notes/_topics/web-presentation-patterns.md
本地界面可包装外部服务 已复用 notes/_topics/web-presentation-patterns.md

相关主题

从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。

主题索引

线程与任务抽象

线程的创建、状态、join/sleep/中断与收束,任务抽象为什么高于线程,线程池与 ForkJoin 的并行度与工作窃取,守护线程、ThreadLocal 与线程私有栈在什么条件下成立,以及并发结构怎样划分执行与状态;Actor/角色把状态隔离到单一线程、用 Inbox 串行收消息,是这条线的另一种解法。

112 张卡片 · 27 本书

主题索引

编程范式与设计

比较函数式与面向对象、一切皆对象、鸭子类型与泛型等语言范式对模块化、复用与扩展的影响。

77 张卡片 · 11 本书

主题索引

线程池容量边界与过载策略

比较线程池/工作队列如何设定容量边界、按任务类型配置线程以及越界后的拒绝、丢弃与背压策略。

75 张卡片 · 34 本书

主题索引

内置数据结构的底层实现

比较字符串、数组、切片、哈希表等内置结构的内存布局、扩容与复制代价。

74 张卡片 · 10 本书

主题索引

语言安全子集与编码纪律

比较如何从语言中划出可靠子集、以编码约定和工具约束规避语言缺陷。

71 张卡片 · 7 本书

主题索引

接口设计与动态分派

比较接口粒度、隐式/显式实现、接口值表示与动态分派的取舍。

66 张卡片 · 18 本书

主题索引

用声明表达接口契约

比较如何借助语言声明(删除、重写标记、异常规格、常量性、作用域等)让编译器强制接口意图。

62 张卡片 · 22 本书

主题索引

资源所有权与生命周期管理

比较不同语言与框架如何表达独占/共享所有权、释放时机和作用域退出清理。

62 张卡片 · 20 本书

主题索引

错误与异常处理机制

比较延迟执行、异常展开、恢复与返回值错误等机制的语义边界。

62 张卡片 · 27 本书

主题索引

代码可读性与命名

比较命名、注释、变量提取与结构选择等降低阅读负担、让代码表达意图的做法。

57 张卡片 · 15 本书

主题索引

Web表现层模式

Web 请求处理与视图生成的拆分:MVC、页面/前端控制器、模板与转换视图、两步视图、应用控制器。

53 张卡片 · 16 本书

主题索引

CSP 通道与取消传播

Go 的 channel、select 与 context:无缓冲通道的同步交接、关闭与 ok 语义、select 默认分支与旁支撤销、取消信号与截止时间如何沿父子任务传播,以及通信表达所有权为什么能把竞态前移到编译期。

26 张卡片 · 5 本书