網站壞了,怎麼找問題 · 第 01 章

把「壞掉了」變成能重現的步驟

先記錄裝置、網址、操作與結果。能穩定重現,才有辦法判斷修好了沒有。

貓老闆的簡報

客人說按了沒反應,你先告訴我他按哪裡、原本該發生什麼。

——貓掌櫃官網的老闆「掌櫃」下需求時的原話

這章做什麼

寫出一份別人照著做就能確認的問題回報,並保存開始前的版本。

動手做

  1. 記下出問題的網址、瀏覽器、畫面寬度與登入狀態,使用虛構資料重做一次。
  2. 列出最短操作:開頁、填資料、按送出;分別寫預期與實際結果,不先猜原因。
  3. 補測電腦和手機各一次,記錄是否只有特定裝置發生。截圖遮住姓名、帳密與金鑰。
  4. 用 Git 記錄目前版本,把問題回報放進專案,確保後續可以比較。

親手試試

示範:網站怪怪的。缺少位置、操作與實際結果,無法判斷修復是否有效。

示範:390px 寬度,開啟候補表單,填入虛構信箱後按送出;預期看到回覆,實際仍停在原畫面。

這是問題描述示範,不表示你的網站一定存在這個錯誤。

圖 C4-01 比較兩種描述,找出讓別人能重現問題的資訊。

這樣對 AI 說

中文就可以
請先協助我整理問題,不要立即改程式。我會提供網址、裝置、瀏覽器與操作步驟。請分別列出預期結果、實際結果、重現頻率和缺少的資訊,提出最少的重現步驟;推測請標成假設。提醒我遮蔽個資與金鑰,並留下目前 Git 版本。

本章驗收清單

請在自己的練習專案實際操作,再依結果逐項確認。

  • 操作步驟能重做出相同現象
  • 預期與實際結果分開記錄
  • 手機與電腦的差異有紀錄
  • 截圖沒有包含敏感資料

這章的相關詞條

詞條頁都有可以動的示範——卡住的時候,去把名詞弄清楚,回來繼續做。

進度只存在這台瀏覽器,不上傳、不追蹤。