Personal site
谨言的网站
名字取自「谨言慎行」，但真到落笔的时候，我往往没这么守规矩。这里放我写的东西、做过的事，以及一些还没想明白的问题。
关于我
About我是谨言，一个把大部分时间花在文字和代码之间的人。
写后端的时间比写文章长，但两件事对我来说其实差不多：都是把一团模糊的东西，慢慢整理成别人能看懂、自己回头看也不脸红的形状。做过几年接口和文档，也短暂地做过一阵子设计，学到的最大一件事是——能删掉的东西尽量删掉。
白天处理需求、排期和一堆细碎的边界情况；晚上读点书，偶尔写长的东西。不太喜欢把话说满，也不太喜欢用「赋能」「闭环」这一类词。想不明白的时候就去骑车，路上往往能把问题想清楚一半。
这个页面没有评论、没有订阅、没有推送。它更像一张放在桌上的纸，你路过看到就看一眼，看不到也不影响什么。
正在做的事
Now-
2025 冬
把长文拆成可复用片段的小工具
写东西时总要反复复制同一段说明，索性自己做一个。前端手写，后端用 Go，数据存在本地，不联网也能用。目前能跑，但搜索还很难用。
在做 -
每周
一篇阅读笔记
主题大多落在技术史和工程实践上：某个人为什么这样选，某个方案当时解决了什么、后来又坏在哪里。写完会搁两天再回头改一遍。
长期 -
重读中
《设计中的设计》第三遍
这次带着尺子和格子纸读，一边读一边记下自己能用的版式规则。已经攒了十几条，其中一半是「不要做什么」。
在读 -
慢慢来
把旧项目里的接口文档重写一遍
不为了交付，只为了让三个月后的自己不用再猜当时为什么那样设计。写文档其实是复盘，写不动的地方通常就是当初没想清楚的地方。
整理
记录
Notes-
关于「慢一点」的几句话
赶出来的东西往往要再赶一遍才能用。后来我把「先做完」改成「先做对一小块」，总时长没变，返工少了。
-
把接口文档当产品写
一个好的接口文档应该让调用方不打电话来问。为此我把每个错误码都补上了「你该怎么做」，篇幅长了三倍，问题少了大半。
-
一次失败的重构复盘
想一口气把两层结构换成一层，结果边界全乱。教训是：重构的第一步不是动手，是先写清楚哪些行为不能变。
-
书架与台灯
换了张能升降的桌子，把台灯挪到左边，晚上写字不再有影子。生活里能让手边清爽一点的改动，回报常常比想象的大。
常读与常用
Shelf- 书
- 《人月神话》
《设计中的设计》
《苏东坡传》
《哥德尔、艾舍尔、巴赫》 - 工具
- vim，用了很多年还是只会那二十个命令
Figma，画草图和版式
一把机械键盘，六年没换 - 习惯
- 早上写字，晚上读书
周末骑车，四十公里左右
每周清一次收件箱和桌面 - 在学
- 把 Go 的并发模型用熟
排版里的网格与留白
怎么把话说短
写信给我
Contact如果你也读同一本书、写过类似的东西，或者手上有一个还没成形的想法——欢迎写信。聊书、聊写法、聊某个具体的技术问题都行，不必客气，也不必先自我介绍。
代码和零散笔记放在 GitHub，用户名同样是 jinyan。回信不一定快，但基本都会回；如果拖了很久，多半是我把这件事忘了，再发一封催一下就好。