我沒有去大學唸電腦科學。我拿的是地球物理學的工學士學位。
我對軟體的理解，是靠閱讀建立起來的。文件、原始碼、GitHub issue、變更紀錄、無疾而終的 RFC 討論串、2014 年那些有一半講錯但卻讓我開始思考的部落格文章。沒有訓練營，沒有系統化課程。只有我、一個瀏覽器，以及真正的材料。
我在學 Cloudflare Workers 的時候，沒有課程可上。我只有 Workers 文件、Wrangler 的變更紀錄，還有一個凌晨 1 點我必須除錯的壞掉部署。我把綁定設定文件讀了三遍，才明白為什麼我的 KV 命名空間無法解析。我跟著一串從 2022 年開始的 GitHub issue 討論，才理解一個官方文件裡根本沒提過的 Wrangler 行為。
我就是這樣學會我所知道的一切。不是靠摘要，而是一直待在材料裡，直到某個瞬間突然想通。
我正在看著這個過程消失。
我們把它稱作生產力
我越來越常看到的模式，不是「我讀了文件，但這段看不懂」，而是「直接給我 X 的程式碼」。不是「我沿著原始碼追下去，發現了這個行為」，而是「這個函式到底在做什麼」。
現在理解變成可有可無。先把輸出拿到手就好。
我們不只是改變了找答案的方式，我們也改變了自己以為的目標。以前的目標是理解，現在的目標是輸出。而我們把這個轉變叫作效率。
它不是。那是技術債。
你可以產生一個可運作的斷路器實作，卻不理解半開狀態是什麼，或為什麼它存在。它在測試環境裡看起來正常。六週後在某個特定邊界案例、負載下失敗，而你沒有任何可以依靠的東西，因為你從來沒有建立過心智模型。你拿到了結論，卻沒有建構過程。只知其然，不知其所以然。
「所以然」才是唯一重要的部分。
閱讀文件會透過接觸真實材料來建立心智模型——API 設計正在處理哪些取捨、你差點跳過的註解裡藏著哪些邊界案例、以及「為什麼」背後的原因。你在讀一份複雜的 RFC 時感到困惑，那正是學習發生的地方。摩擦，才是理解被建立的地方。
當我做 Bookmark Brain——一個基於我自己 5.5 萬多則 X 書籤的 RAG 系統——我必須真的理解 Cloudflare Vectorize 的底層運作。不只是 API 表層。還有 embedding 維度、索引行為、查詢距離度量，以及它們對檢索品質的影響。我讀了 HNSW 論文，也讀了接近原始碼層級的文件。我跟困惑相處得夠久，直到它變成理解。
那份理解現在已經成了正式環境裡的承重結構。萬一凌晨 2 點出問題，我有可以依靠的心智模型。
如果我只是靠提示做出一個能跑的 demo，那我手上就只有一個 demo。我不會有一個我能推理的系統。
程式碼庫裡早已浮現的分裂
誰還在讀、誰已經不讀了——這條分界線正在成形。不是資深與菜鳥，不是有經驗與沒經驗。
它會出現在程式碼審查裡。那個讀過 ORM 文件的開發者，三十秒內就能看出某個查詢為什麼會造成 N+1 問題。靠生成程式碼的開發者看不出來，因為他從來沒有建立過能看見它的模型。
它會出現在架構設計裡。那個讀過 Kafka 文件的開發者，真的理解 consumer group 的行為、partition 指派、offset 管理。當系統需要擴充時，那位開發者手上有可以依靠的東西。只靠摘要學 Kafka 的人，只有詞彙，底下卻沒有結構。
它在除錯時最殘酷地顯現出來。除錯幾乎完全取決於你的心智模型。沒有心智模型，你只是在改東西，然後祈禱。
AI 沒辦法承擔架構。它看不到你整個程式碼庫的全貌。我看過一個由 AI 生成的快取層被乾淨地部署上去，通過了每一個測試，結果三週後把正式環境打掛，因為程式碼裡——或是合併它的人腦中——都沒有人理解：當兩個請求同時競爭去失效同一個 key 時，會發生什麼事。人類在迴圈中必須承擔這件事。而這需要心智模型。心智模型來自閱讀，不是來自提示。
我們在不知不覺間交換掉了什麼
我看過開發者部署出他們無法推理的認證系統。無法解釋的快取層。能運作、直到不能運作的佇列實作，而當它們壞掉時，除了開一個新的聊天視窗之外，什麼都沒有。
那不是工具問題，那是閱讀問題。
同樣的工具，兩個開發者。一個拿它來理解——問程式碼為什麼能運作、取捨是什麼、在高負載下哪裡會壞掉。另一個拿它來避免理解——把輸出拿走、上線、往前走。六個月後，當系統需要變更時，結果完全不同。
界線就在這裡。不是你有沒有用 AI，而是你是在用它理解，還是在用它逃避理解。
我觀察到那些會隨時間持續複利的開發者，並不是跑得最快的那群。他們是那些還在讀的人。讀真正的變更紀錄、真正的查詢規劃文件、當某件事說不通時就去看真正的原始碼。他們正在建立一個會持續增長的心智模型，而提示無法複製這件事。
那些不再閱讀的人，也在建立某種東西。API 表面知識與輸出模式，卻沒有底層結構上的理解。這不會顯現出來，直到系統需要改變。
對自學開發者尤其如此
文件讓自學成為可能。你可以讀開源程式碼。你可以看 Stack Overflow 討論串，裡面有時間戳、爭論、編輯紀錄，讓你看見理解是怎麼演進的。你可以看工程師的部落格文章，他們不只講做了什麼，還會講為什麼這麼做。
那套課綱現在仍然存在。我還在用。我只是越來越不知道，站在我後面往前走的人，還有多少人會這麼做。
我今天能建出這些東西，是因為我把那些讓我困惑的內容一直讀到不再困惑。那不是天賦，那是練習。而我每天都看著開發者為了「移動更快」的感覺，把這種練習交換掉，卻沒注意到他們交換掉的其實是那項真正的技能。
你在凌晨 1 點，挫折地讀文件、同一段看了三遍，靠閱讀建立起來的心智模型——那不是你生產力上的稅。那才是系統壞掉時，讓你無法被取代的東西。
當你跳過它，你就跳過了思考。而你不會知道自己跳過了，直到你人在正式環境裡，卻什麼都沒有可以依靠。
AI 幫我研究、整理結構與編輯這篇文章。裡面的論點、例子與觀點都出自我本人。至於其中有什麼錯誤，也同樣是我的。
原文出處：https://dev.to/dannwaneri/you-stopped-reading-the-docs-now-you-dont-understand-the-systems-go1
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式
