Go标准库是日常开发的实用工具箱,新手应聚焦net/http、encoding/json、os/io、sync/context等高频模块,掌握关键陷阱与最佳实践,而非追求全面覆盖。

从 net/http 入手,不是因为它是“最酷”的,而是因为你第一天写 API 就绕不开它
几乎所有 Go 新手的第一个可运行服务,都是 http.HandleFunc + http.ListenAndServe 搭出来的。但很多人卡在:为什么路由不生效?为什么 POST 数据读不到?为什么中文乱码?
-
http.Request.Body是io.ReadCloser,必须调用defer r.Body.Close(),否则后续请求可能 hang 住(尤其压测时) -
r.ParseForm()和json.NewDecoder(r.Body).Decode()不能混用——前者会提前读走 Body,后者再读就得到空数据 -
http.ResponseWriter不支持多次WriteHeader,第二次调用会被忽略,状态码永远是第一次的 - 本地开发建议加
http.Server实例(而非直接用http.ListenAndServe),方便设置ReadTimeout/WriteTimeout,避免调试时被超时静默杀掉连接
encoding/json 看似简单,但字段标签、嵌套结构、空值处理全是高频翻车点
JSON 序列化/反序列化不是“加个 json:"name" 就完事”。实际项目里,你会频繁遇到:API 返回字段名要小写但结构体首字母大写、null 字段想忽略、时间格式不一致、嵌套 map 解析失败。
-
json:"name,omitempty"只对零值(""、0、false、nil)生效,但*string类型的 nil 指针不会被跳过,需配合自定义MarshalJSON方法 -
time.Time默认序列化为 RFC3339 字符串(如"2026-01-12T13:11:00+08:00"),若后端要求"2006-01-02",必须用type MyTime time.Time+ 自定义MarshalJSON - 解析未知结构用
map[string]interface{}很方便,但深层嵌套后类型断言极易 panic,推荐用gjson或先定义最小结构体
os、io、bufio 这组 I/O 工具,别死记函数,重点记“谁负责关闭、谁可能阻塞”
文件读写崩得悄无声息:程序没报错,但文件没写完、日志丢失、goroutine 泄漏。问题往往出在资源生命周期管理上。
此版本为旅行社简版(免费版),只有旅游线路相关功能,互相交流学习为目的,您也可以免费使用此版本。如需更多功能(旅游、酒店、机票、租车、门票等),请查看标准版演示 后台管理地址:http://你的网址/admin/ 默认用户名:admin 默认密码:000000 佳旅通旅游网站管理系统 标准版说明 佳旅通旅游网站管理系统是一套专业的旅游行业电子商务平台。适用于旅行社网站,机票网站建设。系统功能完
-
os.OpenFile返回的*os.File必须显式Close();用defer f.Close()前确认 f 不是 nil(比如os.OpenFile返回 error 时不该 defer) -
io.Copy是流式复制,内部有 32KB 缓冲区,适合大文件;小数据用io.WriteString更轻量,但注意它不自动换行 -
bufio.Scanner默认单行上限 64KB,读超长日志行会直接Scan() == false且Err() != nil,需提前Scanner.Buffer扩容 -
ioutil.ReadAll已被弃用(Go 1.16+),统一用io.ReadAll;但它会把整个文件加载进内存,千万慎用于 GB 级日志
别一上来啃 reflect 或 unsafe,优先吃透 sync、context、errors 这三个“粘合剂库”
它们不直接实现业务逻辑,但决定了你的代码能不能在线上稳住、出错时能不能快速定位、并发场景下会不会数据错乱。
立即学习“go语言免费学习笔记(深入)”;
-
sync.WaitGroup的Add()必须在go语句前调用,放反了会导致Wait()永远不返回(常见于 for 循环中漏写) -
context.WithTimeout创建的 ctx,其Done()channel 在超时或取消后**永远关闭**,不可重用;每次 HTTP 请求都应新建 context -
errors.Is和errors.As是 Go 1.13+ 错误链的标准解法,但要注意:只有用fmt.Errorf("wrap: %w", err)包装的错误才支持向下查找,errors.New("xxx")或fmt.Errorf("xxx")(无 %w)会断链
net/http 负责接流量、encoding/json 负责编解码、sync 负责保安全、context 负责传取消信号——然后在每个节点上,只深挖那几个你明天就要写的函数,其余先标灰,用到再亮。








