别再误会了：Go 里的 go.sum 其实不是锁文件
很多 Go 开发者会把 go.sum 误认成 package-lock.json 一类的锁文件，但它并不参与版本解析。真正需要厘清的是：go.mod 负责依赖版本与构建选择，go.sum 负责校验依赖内容是否被篡改，两者分工完全不同。 不少 Go 开发者都会把 go.sum 顺手理解成锁文件，但这恰好会把 Go 模块系统里最关键的职责分工看反。
2026-08-25
84
很多 Go 开发者会把 go.sum 误认成 package-lock.json 一类的锁文件，但它并不参与版本解析。真正需要厘清的是：go.mod 负责依赖版本与构建选择，go.sum 负责校验依赖内容是否被篡改，两者分工完全不同。 不少 Go 开发者都会把 go.sum 顺手理解成锁文件，但这恰好会把 Go 模块系统里最关键的职责分工看反。
很多 Go 开发者熟悉 JSON、Protobuf，却很少认真评估标准库里的 `encoding/gob`。这篇文章从原理、基本用法、适用场景和常见限制四个方面梳理 `gob`，帮助你判断它是否适合纯 Go 项目的内部通信与数据持久化。 在 Go 项目里，一提到序列化，很多人先想到的都是 JSON 或 Protobuf ，标准库自带的 gob 往往反而被忽略。
看 MySQL 的 EXPLAIN，真正有判断价值的字段并不多，核心是 type、key、rows、filtered 和 Extra。本文按“先看什么、为什么要用 JSON、哪些结论必须二次验证、跨数据库怎么避免误判”四个问题展开，帮助你把执行计划从“会看”变成“能据此定位问题”。
`go list` 经常被当成“列包命令”，但它真正的价值在于把 Go 包、模块和依赖关系变成可查询的数据。本文从基础输出讲到 `-json`、`-m`、`-f`、`-deps`、`-tags` 等常用组合，帮助你判断它适合拿来查什么、何时能替代手工排查。
给 Go 程序加上可查询的版本号，不一定要引入第三方库。本文用标准库配合 `go build -ldflags`，演示如何在构建阶段注入版本号、构建时间和 Git 提交，并进一步补上 JSON 输出与 Makefile 自动化构建。 线上排查 Go 程序时，最常见的问题不是服务起不来，而是程序已经在跑，却说不清自己来自哪次构建。
Go 里处理 JSON 并不难，难的是接口返回结构不稳定时，既要保留灵活性，又不想把代码写成一串类型断言。本文按常见场景梳理 `map[string]interface{}`、`interface{}`、`json.RawMessage`、反射和泛型的用法，并给出接口开发中更稳妥的取舍建议。
Go 里的 nil 切片和空切片打印出来都像 `[]`，但它们在底层指针、`nil` 比较、内存分配和 JSON 序列化上的表现并不一样。本文从切片结构入手，用代码和常见业务场景把两者的差异讲清，并给出判断空值、接口返回和序列化转换时更稳妥的写法。
`composer.json` 是 PHP 项目的依赖清单，也是包信息、自动加载和脚本入口的配置中心。本文按“项目元数据、依赖声明、自动加载、脚本调用”四部分拆解常见字段，帮助你判断哪些配置是必须项，哪些只在开发和发布阶段才需要补充。
Composer 是 PHP 项目里最常用的依赖管理工具之一，但很多初学者只会执行命令，对 `composer.json`、`composer.lock` 和 `vendor` 的分工并不清楚。本文用一个安装 `monolog/monolog` 的最小示例，梳理 Composer 的基础工作方式、自动加载和几条最常用命令。
在 Go 服务里做请求级日志追踪，不一定要先上复杂方案。用标准库 `log` 在请求开始、处理过程和结束三个位置打点，就能把一次请求的路径和耗时串起来；等到需要结构化输出、级别过滤或 JSON 日志时，再替换成 `logrus`、`zap` 这类库即可。
这篇文章围绕 Scalatra 返回 JSON 时最常见的几个问题展开：为什么配置后仍然输出默认字符串、普通类为何不会自动序列化、动态字段和 JSONP 又该怎么处理。文中按实际排错顺序梳理依赖、Mixin、序列化方式与组织建议，便于快速对照落地。
这篇文章整理了一个在 PHP 5.4 及以上版本中格式化输出 JSON 的简洁方法。重点不在复杂封装，而是说明 `json_encode` 配合 `JSON_UNESCAPED_UNICODE` 与 `JSON_PRETTY_PRINT` 的实际作用，以及如何兼顾浏览器直接输出和字符串返回两种用法。 开发 PHP 接口或排查数据结构时，最常见的问题不是能不能输出 JSON，而是输出后难不难读。
