如何在 Mac 拍下有用的錯誤報告截圖
好的截圖能顯示哪裏出錯;有用的錯誤報告還會說明如何重現。
只有故障畫面的截圖仍留下幾個疑問:哪個動作引發問題?原本應該出現甚麼結果?每次都會發生嗎?配合聚焦的截圖和簡短說明,調查的人才可以重現問題。
以下介紹回報 Mac 應用程式或網站問題的實用流程,並附上一份可複製到問題追蹤系統或支援訊息的範本。
1. 在畫面中保留足夠背景
盡可能把出問題的控制項和結果一併截入畫面。如果按下「儲存」後出現錯誤,請包括按鈕、錯誤訊息和相關表格。整個桌面會令細節難以找到;只截錯誤訊息又可能看不出它來自哪個畫面。
重現問題時使用範例內容。裁走無關分頁和帳戶資料。最好在截圖前從原有畫面移除登入資料和私人資訊;輕微模糊無法可靠地遮住文字。
Floatie 的區域截取會讓結果浮在螢幕上,方便你返回應用程式檢查步驟。若需要另一個狀態來解釋過程,請另外截圖。
2. 標出觀察到的問題,再補充說明
通常一支箭嘴指向故障控制項便足夠。讀者要按次序查看時才加上編號,並在附件旁寫下說明。不要在錯誤訊息或顯示問題的數值上畫線。
選取 Floatie 截圖後按 ⌘E,會開啟 Pro 編輯器,可加入箭嘴、文字和編號。編輯器功能頁面介紹了各項工具。
請於星期五前付運。
卡號已建檔——請勿重寄。
如果錯誤只出現在圖片中,可以用 OCR 複製圖片文字。請將複製結果與原圖核對,尤其留意標點和外觀相似的字元。可搜尋的錯誤文字除了放在圖片上,也應寫入報告。
3. 加入這份重現問題範本
以下範例是虛構的,請換成你實際觀察到的內容。
標題:輸入專案名稱後,「儲存」仍然停用
環境:
- 應用程式和版本:
- macOS 版本:
- 瀏覽器和版本(如適用):
步驟:
1. 開啟新專案。
2. 輸入名稱。
3. 嘗試選擇「儲存」。
預期結果:輸入有效名稱後,「儲存」按鈕可以使用。
實際結果:「儲存」按鈕仍然停用。
發生頻率:3 次嘗試中重現 3 次。
附件:project-save-disabled.png
發生頻率要按實際測試的情況填寫。如果只發生過一次,就如實說明。網站排版問題若受視窗大小或縮放設定影響,也請記下。
4. 選擇截圖或錄影
數值錯誤、標籤遺失或版面錯亂等問題適合用截圖。選單消失、意外捲動或一連串點擊操作,短片會更有幫助。只錄下畫面中相關的部分,問題顯示出來後就停止。
如需令附件隨報告保留下來,請上載檔案。提交前開啟附件,確認重要文字清晰可讀。遇到大小限制時,可縮小螢幕截圖,同時保留相關細節。
準備好浮起來了嗎?
所有功能解鎖,免費試用 14 天。之後,一次過購買即可永久使用 Floatie Pro;月費或年費方案也可達到相同效果,並加入 Floatie Link Pro。