雜記 › 技術筆記 › 雜記專欄都在寫什麼?工具實測、踩坑與分類導覽

雜記專欄都在寫什麼?工具實測、踩坑與分類導覽

工具頁能寫清一個功能支援哪些輸入、輸出哪一項,卻答不了另一類問題:我手上這件事該不該用它,用它拿到的結果該怎麼讀。雜記收的是後面這半部分,問題確實發生過,當時怎麼定位、依據什麼判斷、哪種情況下結論會反過來。分工是固定的,工具頁只寫能做什麼,文章寫什麼情況該用它,同一件事在兩邊是兩份內容,誰也不能替誰補齊,這是第一次進來最容易混淆的一層關係。這一頁不解決具體報錯,只交代三件事:內容有哪兩種形態、三個分類各自收什麼、想不起工具名時該拿什麼詞去找。

一、從位址就能看出這一頁是哪種內容

先看路徑。工具頁掛在根路徑上,形如 /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 篇覆蓋的格式與文字問題最多;要交出去的是檔案、圖片或碼,從資源分享開始,先確認下一個環節要什麼再回來定參數;只是想核對一個自己算出來的數,生活隨筆最短,幾篇看完就能判斷工具的結論能不能直接引用。

📎 相關文章

PNG 壓了三遍只減 426 位元組:無損壓縮的真實邊界 2026-10-22 WebP 轉 PNG 後體積漲了幾倍:什麼時候必須轉,怎麼把漲幅壓住 2026-10-22 截圖縮到四分之一,小字糊成一團的三種原因 2026-10-22 同樣裁 300×300,頭像為什麼總偏右下角半格 2026-10-22 按每月 1.7 倍預估 18 個月,腳本和表格為什麼給出兩個數 2026-10-22