最近我在開發一個專案,只是想在 Markdown 標題和下面的清單之間補一個空行。Claude Code(Opus 5.5)講起測試,幾句話裡就冒出了 oracle 和 golden file。我一時沒看懂,腦中浮現的是資料庫和一份金光閃閃的檔案。一個空行還沒補上,我倒是先補了一堂英文課。
順著測試的意思看下去,事情其實滿直白的。要知道程式補的空行對不對,得先有個可信的來源給答案,再把預期結果存起來,留給測試比對。Claude Code 說的兩個詞,剛好各管一件事。
這篇就拿那個空行來拆解 oracle 和 golden,再補幾句平常看食譜、聊天或讀測試程式時用得上的英文。

文中的 Markdown 範例以一條測試規則為前提:當標題後面緊接著清單時,中間要補一個空行。
Oracle 是可以去問答案的對象
Oracle 是名詞,美式讀音是 /ˈɔːrəkl/,重音在第一音節。古希臘人會到 Delphi(德爾菲)求問神意。英文裡的 oracle 可以指接受求問的地方、傳達神意的人,也可以指傳達出來的神諭。這個字經古法語進入英文,往前可以追到拉丁文 oraculum,和表示「說話」的 orare 有關。Oxford Learner’s Dictionaries
今天也可以半開玩笑地叫某個人 the oracle。例如團隊裡有個人很熟舊版系統,遇到古怪的行為大家都會找他。我在工作場合通常會說 go-to person,一句話就能說清楚要找誰。用 oracle 就多一點「這個只有他知道」的玩笑味道。下面兩句可以拿來比較語氣。
She’s our oracle on the old billing system.
她對舊帳務系統瞭若指掌,有事問她就對了。
She’s our go-to person for billing questions.
有帳務問題,我們通常會找她。
測試文章裡的 test oracle 沿用了「有個地方可以問答案」的意思。我寫了一支計算帳單的程式,跑出 500 元。要知道這個測試該通過還是失敗,我得有依據判斷 500 元對不對。人工依規格算出的金額、另一支參考程式,或是檢查總金額是否等於各項加總的斷言,都可以提供判斷依據。實務上先問自己這個測試要驗證什麼,再決定哪個來源有資格給答案。The Oracle Problem in Software Testing: A Survey
Golden 從金黃色延伸到值得留存的基準
Gold 可以當名詞,指黃金。Golden 通常是形容詞,美式讀音是 /ˈɡoʊl.dən/,重音也在第一音節。食譜的 golden brown 說的是顏色,a golden opportunity 說的是難得的好機會。工作上還會看到 a golden rule,意思是有一條原則特別重要,值得記起來。Cambridge Dictionary
Bake the cookies until the edges are golden brown.
把餅乾烤到邊緣呈金棕色。
It’s a golden opportunity to learn from the team.
這是向團隊請教的好機會。
My golden rule for reviewing diffs is to check the input first.
我看差異時最重視的一條原則,就是先確認輸入。
到了測試裡,golden file 通常就是「存著預期結果的比對基準檔」。它可以是一份 JSON、純文字或圖片。像 Flutter 的 matchesGoldenFile('save.png'),會拿測試渲染出來的畫面和既有的 PNG 比對。假如儲存按鈕無意間往旁邊偏移,影像比對可以把這個差異抓出來。如果按鈕本來就要移位置,先確認新畫面符合設計,再更新那張 PNG。Flutter API 文件
Compare the rendered button with the golden file.
把渲染出來的按鈕和基準圖檔比對。
用一個 Markdown 空行把兩個字串起來
回到開頭那個空行。假設我手上有一份可信的 Markdown 修正程式,現在要測試另一份實作能不能做出相同的修正。我拿下面這段當輸入。
# 使用說明
1. 複製內容
2. 貼上內容
這時,參考實作就扮演 oracle。我拿同一段 Markdown 和同一組規則去問它,它會指出標題後少一個空行,並產生下面這份修正結果。
# 使用說明
1. 複製內容
2. 貼上內容
我可以把這份預期結果存成 golden file。每次跑測試,就讓待測的程式處理同一段 Markdown,再拿輸出跟基準檔對答案。也可以另外測一次關閉規則的情況,確認原本的排版有保留下來。
如果測試亮紅燈,我會先看差異。像這個例子,可能是程式少補一個空行,也可能是規則已經改了,基準檔還留著舊答案。看完差異,再決定要修程式還是更新基準檔。
總結
我用兩個英文動詞記這組詞。Consult the oracle 是去找能提供判斷依據的來源。Compare against the golden file 是拿測試輸出跟已存下的預期結果比對。下次 Claude Code 又把這兩個詞擺在一起,我就想想那個空行,先問誰能給答案,再看答案存在哪裡。
相關連結