工具頁能寫清一個功能支援哪些輸入、輸出哪一項,卻答不了另一類問題:我手上這件事該不該用它,用它拿到的結果該怎麼讀。雜記收的是後面這半部分,問題確實發生過,當時怎麼定位、依據什麼判斷、哪種情況下結論會反過來。分工是固定的,工具頁只寫能做什麼,文章寫什麼情況該用它,同一件事在兩邊是兩份內容,誰也不能替誰補齊,這是第一次進來最容易混淆的一層關係。這一頁不解決具體報錯,只交代三件事:內容有哪兩種形態、三個分類各自收什麼、想不起工具名時該拿什麼詞去找。
一、從位址就能看出這一頁是哪種內容
先看路徑。工具頁掛在根路徑上,形如 /json-format;文章統一在 /notes/ 下面,形如 /notes/json-format-guide。同一主題兩邊各有一頁,位址只差這一層前綴。網址列因此是第一個篩子:帶 /notes/ 的,這一頁在講一次判斷過程,參數只在需要時出現;不帶前綴的是功能頁,翻完就能確定能不能用。
站內現在有 101 個工具頁、58 篇文章,這個數量差本身就是收錄方式:不是每個功能都配一篇。文章內部還有第二種分法,這一層比分類更影響你怎麼用它們。
- 一種是單個工具的問題貼。標題就是那次報錯或困惑,正文交代輸入長什麼樣、為什麼這次選它、它在什麼前提下會給出不該直接引用的結果。介面回傳被壓成一行、要在裡面找一處值那一類屬於這種:先講怎麼讀這種寫法,再給JSON 格式化把回傳攤開或者壓回去。
- 另一種是跨幾個功能的完整流程,一件事從頭做到尾中間換了幾個工具,單看任何一頁說明都拼不出整體。這類文章會寫明下一步為什麼要換功能,這是工具頁沒有的內容。
文章裡凡提到某個功能,都指回它自己的工具頁,站內平均每篇埋 1 到 3 條這樣的連結。可以把文章當路線圖、把工具頁當終點:要動手就點過去,只想弄明白原理就留在原句裡。
二、三個分類各自收什麼
分類只有三種,邊界按收錄對象劃,不按學科劃。下面這張表是這一欄的實際範圍。
| 分類 | 收錄範圍 | 典型問題形態 | 正文裡的例子 |
|---|---|---|---|
| 技術筆記(31 篇) | 資料格式、文字規則、編碼、檔名與路徑處理 | 貼進去就報錯但看不出哪一處;兩段文字看著一樣卻比不相等 | 介面回傳的 JSON 壓成一行看不懂;檔名帶空格或中文時路徑怎麼拼 |
| 生活隨筆(13 篇) | 日常要算、但手邊沒有公式的數 | 只有條件,想知道結果以及這個演算法能不能信 | 距離過年還有多少天;分數和排列組合怎麼算才不繞 |
| 資源分享(14 篇,含本篇) | 圖片、QR code、條碼、老照片這類交付物 | 東西已經有了,只在不重做的前提下改到下一個環節能用 | 圖片壓到多少才不糊;老照片放大就發糊 |
技術筆記佔 31 篇,是最大的一塊,收的幾乎都不是怎麼寫程式碼,而是這段資料為什麼不對。JSON、正規表示式、編碼、路徑這幾條線上的坑,多數來自同一種誤判:把一段東西當成另一種格式,或者拿肉眼去核對不上的字元。這類正文通常會把原樣字元擺出來,光靠描述說不清。
生活隨筆只有 13 篇,問題更具體:分數怎麼算、排列組合什麼時候不該乘、節日倒數按不按當天、干支怎麼推。共同點是手邊沒有公式,而結果還要給別人看,所以這類正文會寫清取整和邊界怎麼定,而不是只丟一個數出來。
資源分享的 14 篇裡包含這一篇導覽。它的特點是交付物本來就在讀者手上,問題很少是東西不存在,更多是做出來的東西在下一個環節用不了。圖片壓到多少才不糊、老照片放大就發糊、碼貼出去掃不出來,答案取決於要投到哪裡,不取決於任何預設值。
三、想不起工具名的時候,按問題去找
工具名是站內的叫法,問題是自己的說法,兩邊經常對不上。要找的其實不是上次用過哪個功能,而是這類文章的標題怎麼寫。標題按困惑的原句寫,比如兩份名單裡誰只在其中一份。檢索時把自己的困惑說成一句話去對標題,通常比按工具名翻列表更快。
幾個能直接套用的改法:
- 把想讓圖片小一點換成圖片壓完又變糊。後一句才是問題的形狀,也更接近標題寫法;這次要用的功能是圖片壓縮。
- 把怎麼比兩份名單換成誰只出現在其中一份。前者在功能名裡找不到對應,後者落到文章標題上就是原句。
- 內容要發出去之前先換一個問法:這裡面有沒有不該給別人看的。截圖和記錄裡帶手機號碼、姓名、住址的那一類,處理動作在隱私資訊遮蔽,文章講的是哪些欄位必須擋、擋到什麼程度還能核對回去。
位址也能幫你確認沒看錯頁:搜到一條結果,先看有沒有那層 /notes/ 前綴,在就說明你讀的是判斷依據,不在就說明已經站到功能頁上了。
四、更新節奏和分類邊界
分類名固定三種,不會加第四種。收錄按兩件事累積:站上新加了一個功能,或者同一類問題被反覆撞到,才會有一篇新的。沒有固定週期,也不做任何週期性的承諾,因為一篇能用的記錄需要的資訊比「有更新」這三個字多。
有些內容看著同時像兩類,這時以你手上有什麼為準。手上是一段資料或者一個報錯,看技術筆記;手上就是要交出去的檔案、圖片或碼,看資源分享;兩者都不是、只想核對一個自己算出來的數,看生活隨筆。這條線按輸入劃分,比爭論某件事算不算技術更省事。
五、常見問題
Q:文章和工具頁有什麼不同,我該先看哪個?
工具頁回答能做什麼,文章回答什麼時候該用、結果怎麼讀。確定要動手就從工具頁開始,它對輸入輸出的說法更準;還在判斷這件事有沒有現成功能可用,就從文章開始,裡面有別人撞過的那部分。
Q:想不起工具叫什麼,只記得問題怎麼辦?
把問題說成一句完整的話,再拿它去對文章標題。標題就是按當時的困惑寫的,比如圖片壓到多少才不糊。對上任何一篇,文中就會指向對應功能頁,不需要先知道它叫什麼。
Q:這些內容多久更新一次?
按工具和問題累積,沒有固定週期。58 篇文章對著 101 個工具頁,多數功能目前沒有配套文章,這只說明還沒人把那件事寫成記錄,不代表功能本身做不到。
Q:一篇內容會不會同時屬於兩個分類?
會,邊界靠你手上的輸入定:報錯和資料歸技術筆記,現成檔案歸資源分享,純算數歸生活隨筆。這一篇導覽就歸在資源分享的 14 篇裡,它既不是某個工具的問題貼,也不解決具體一件事。
Q:按問題搜了一圈沒找到,是不是站內沒收錄?
大概率是沒有對應的記錄。這種情況直接看工具頁更省事,參數和支援範圍都寫在功能頁上;文章的缺失只說明缺一份判斷依據,不等於缺一個功能。
第一次進這一欄,按此刻手上的東西挑一類開始。螢幕上正有報錯,或者一段資料讀不下去,從技術筆記往下找,那 31 篇覆蓋的格式與文字問題最多;要交出去的是檔案、圖片或碼,從資源分享開始,先確認下一個環節要什麼再回來定參數;只是想核對一個自己算出來的數,生活隨筆最短,幾篇看完就能判斷工具的結論能不能直接引用。