工具页能写清一个功能支持哪些输入、输出哪一项，却答不了另一类问题：我手上这件事该不该用它，用它拿到的结果该怎么读。杂记收的是后面这半部分，问题确实发生过，当时怎么定位、依据什么判断、哪种情况下结论会反过来。分工是固定的，工具页只写能做什么，文章写什么情况该用它，同一件事在两边是两份内容，谁也不能替谁补齐，这是第一次进来最容易混淆的一层关系。这一页不解决具体报错，只交代三件事：内容有哪两种形态、三个分类各自收什么、想不起工具名时该拿什么词去找。
一、从地址就能看出这一页是哪种内容
先看路径。工具页挂在根路径上，形如 /json-format；文章统一在 /notes/ 下面，形如 /notes/json-format-guide。同一主题两边各有一页，地址只差这一层前缀。地址栏因此是第一个筛子：带 /notes/ 的，这一页在讲一次判断过程，参数只在需要时出现；不带前缀的是功能页，翻完就能确定能不能用。
站内现在有 101 个工具页、58 篇文章，这个数量差本身就是收录方式：不是每个功能都配一篇。文章内部还有第二种分法，这一层比分类更影响你怎么用它们。
- 一种是单个工具的问题贴。标题就是那次报错或困惑，正文交代输入长什么样、为什么这次选它、它在什么前提下会给出不该直接引用的结果。接口返回被压成一行、要在里面找一处值那一类属于这种：先讲怎么读这种写法，再给JSON格式化把返回摊开或者压回去。
- 另一种是跨几个功能的完整流程，一件事从头做到尾中间换了几个工具，单看任何一页说明都拼不出整体。这类文章会写明下一步为什么要换功能，这是工具页没有的内容。
文章里凡提到某个功能，都指回它自己的工具页，站内平均每篇埋 1 到 3 条这样的链接。可以把文章当路线图、把工具页当终点：要动手就点过去，只想弄明白原理就留在原句里。
二、三个分类各自收什么
分类只有三种，边界按收录对象划，不按学科划。下面这张表是这一栏的实际范围。
| 分类 | 收录范围 | 典型问题形态 | 正文里的例子 |
|---|---|---|---|
| 技术笔记（31 篇） | 数据格式、文本规则、编码、文件名与路径处理 | 粘进去就报错但看不出哪一处；两段文字看着一样却比不相等 | 接口返回的 JSON 压成一行看不懂；文件名带空格或中文时路径怎么拼 |
| 生活随笔（13 篇） | 日常要算、但手边没有公式的数 | 只有条件，想知道结果以及这个算法能不能信 | 距离过年还有多少天；分数和排列组合怎么算才不绕 |
| 资源分享（14 篇，含本篇） | 图片、二维码、条形码、老照片这类交付物 | 东西已经有了，只在不重做的前提下改到下一个环节能用 | 图片压到多少才不糊；老照片放大就发糊 |
技术笔记占 31 篇，是最大的一块，收的几乎都不是怎么写代码，而是这段数据为什么不对。JSON、正则、编码、路径这几条线上的坑，多数来自同一种误判：把一段东西当成另一种格式，或者拿肉眼去核对不上的字符。这类正文通常会把原样字符摆出来，光靠描述说不清。
生活随笔只有 13 篇，问题更具体：分数怎么算、排列组合什么时候不该乘、节日倒数按不按当天、干支怎么推。共同点是手边没有公式，而结果还要给别人看，所以这类正文会写清取整和边界怎么定，而不是只丢一个数出来。
资源分享的 14 篇里包含这一篇导览。它的特点是交付物本来就在读者手上，问题很少是东西不存在，更多是做出来的东西在下一个环节用不了。图片压到多少才不糊、老照片放大就发糊、码贴出去扫不出来，答案取决于要投到哪里，不取决于任何默认值。
三、想不起工具名的时候，按问题去找
工具名是站内的叫法，问题是自己的说法，两边经常对不上。要找的其实不是上次用过哪个功能，而是这类文章的标题怎么写。标题按困惑的原句写，比如两份名单里谁只在其中一份。检索时把自己的困惑说成一句话去对标题，通常比按工具名翻列表更快。
几个能直接套用的改法：
- 把想让图片小一点换成图片压完又变糊。后一句才是问题的形状，也更接近标题写法；这次要用的功能是图片压缩。
- 把怎么比两份名单换成谁只出现在其中一份。前者在功能名里找不到对应，后者落到文章标题上就是原句。
- 内容要发出去之前先换一个问法：这里面有没有不该给别人看的。截图和日志里带手机号、姓名、住址的那一类，处理动作在隐私信息遮掩，文章讲的是哪些字段必须挡、挡到什么程度还能核对回去。
地址也能帮你确认没看错页：搜到一条结果，先看有没有那层 /notes/ 前缀，在就说明你读的是判断依据，不在就说明已经站到功能页上了。
四、更新节奏和分类边界
分类名固定三种，不会加第四种。收录按两件事积累：站上新加了一个功能，或者同一类问题被反复撞到，才会有一篇新的。没有固定周期，也不做任何周期性的承诺，因为一篇能用的记录需要的信息比有更新这三个字多。
有些内容看着同时像两类，这时以你手上有什么为准。手上是一段数据或者一个报错，看技术笔记；手上就是要交出去的文件、图片或码，看资源分享；两者都不是、只想核对一个自己算出来的数，看生活随笔。这条线按输入划分，比争论某件事算不算技术更省事。
五、常见问题
Q：文章和工具页有什么不同，我该先看哪个？
工具页回答能做什么，文章回答什么时候该用、结果怎么读。确定要动手就从工具页开始，它对输入输出的说法更准；还在判断这件事有没有现成功能可用，就从文章开始，里面有别人撞过的那部分。
Q：想不起工具叫什么，只记得问题怎么办？
把问题说成一句完整的话，再拿它去对文章标题。标题就是按当时的困惑写的，比如图片压到多少才不糊。对上任何一篇，文中就会指向对应功能页，不需要先知道它叫什么。
Q：这些内容多久更新一次？
按工具和问题积累，没有固定周期。58 篇文章对着 101 个工具页，多数功能目前没有配套文章，这只说明还没人把那件事写成记录，不代表功能本身做不到。
Q：一篇内容会不会同时属于两个分类？
会，边界靠你手上的输入定：报错和数据归技术笔记，现成文件归资源分享，纯算数归生活随笔。这一篇导览就归在资源分享的 14 篇里，它既不是某个工具的问题贴，也不解决具体一件事。
Q：按问题搜了一圈没找到，是不是站内没收录？
大概率是没有对应的记录。这种情况直接看工具页更省事，参数和支持范围都写在功能页上；文章的缺失只说明缺一份判断依据，不等于缺一个功能。
第一次进这一栏，按此刻手上的东西挑一类开始。屏幕上正有报错，或者一段数据读不下去，从技术笔记往下找，那 31 篇覆盖的格式与文本问题最多；要交出去的是文件、图片或码，从资源分享开始，先确认下一个环节要什么再回来定参数；只是想核对一个自己算出来的数，生活随笔最短，几篇看完就能判断工具的结论能不能直接引用。