問題回報用的截圖:留什麼、遮什麼、怎麼標
一張好的錯誤截圖要保留的東西,通常比回報者以為的多。這篇講該留什麼、該遮什麼,以及為什麼裁得太乾淨反而害了要修這個問題的人。
你遇到一個問題,要回報給工程師、客服或廠商。你截了圖、把出錯的那塊裁出來、畫了一個紅框,送出。三天後對方回你「可以提供完整畫面嗎」,然後那個畫面已經不存在了。這篇要講的就是怎麼一次就給對,以及為什麼「裁乾淨」在這個場合通常是幫倒忙。
核心的差別在這裡:社群上的截圖是給人看的,目標是把雜訊拿掉;問題回報的截圖是給人查的,目標是把線索留著。要修這個問題的人在意的東西,經常不是你圈起來的那一塊。
一張好的錯誤截圖要包含什麼
- 整個視窗,不是只有出錯的那個區塊。視窗標題、網址列、分頁、側邊欄的狀態——這些告訴對方你當時在哪一頁、用哪個帳號、開著什麼。
- 錯誤訊息的完整原文,一個字都不要少。錯誤碼、代號、那串看起來像亂碼的識別字,往往就是唯一能直接對到日誌的線索。
- 畫面上的時間。有了時間,對方才能去伺服器日誌裡撈同一時刻的紀錄。截圖裡如果沒有,就在文字說明裡補上(含時區)。
- 「出錯之前的狀態」。表單裡填了什麼、勾了哪些選項、上一步做了什麼。很多問題只有在特定輸入下才會出現。
- 你的環境:系統版本、App 版本或瀏覽器版本。App 的版本號通常在設定或「關於」頁面裡,順手多截一張。
- 如果錯誤是間歇性的,兩張截圖:正常的那次和出錯的那次。差異本身就是線索。
裁得太乾淨為什麼會害了對方
這是最常見也最花時間的失誤。你看到紅色的錯誤字串,很自然地把它裁出來——你以為你交出了重點,實際上你把周圍所有可以縮小範圍的資訊都丟了。
舉幾個真的發生過的形狀:錯誤訊息裁出來了,但網址被裁掉,對方不知道你在哪一頁;金額不對的那一行裁出來了,但上面的篩選條件被裁掉,而問題就出在篩選條件;App 當掉的畫面裁出來了,但狀態列被裁掉,於是沒人知道當時是不是沒有網路。
一條可以直接用的原則:先給整張,再用標註指出重點。留著背景不會讓對方看不懂——他有你的箭頭。裁掉背景才會讓他看不懂,因為那些資訊已經不在了。真的太大,就給整張加上一張放大的局部,兩張一起送。
進共用系統之前要遮掉什麼
這一節和上一節是互相拉扯的,必須同時處理。一張問題回報的截圖通常會進入某個共用的地方——Jira、Notion、共用資料夾、群組聊天——而那裡的可見範圍比你當下想的大得多,並且會留很久。
- 真實客戶的姓名、電話、地址、訂單編號、身分證字號。內部系統畫面上這些東西通常整片都是。
- 你自己的登入權杖、Cookie、API key。如果你截的是開發者工具的畫面,這一項幾乎一定在。
- 網址裡的一次性參數。有些連結本身就等於一組憑證。
- 和這個問題無關的另一位同事的訊息、郵件主旨、行事曆內容。
- 薪資、合約金額、還沒公開的專案代號——這些不是個資,但外流一樣會出事。
這裡有一個實務上的取捨:遮蔽會拿掉線索。做法是遮掉「值」,留下「形狀」——把客戶姓名蓋掉,但留著那一欄還在、留著它有幾筆;把訂單編號蓋掉,但在文字說明裡告訴對方那筆編號的前兩碼或它的格式。這樣對方知道結構,卻拿不到內容。如果那個值本身就是重現問題的關鍵,就不要放進共用系統,改用私訊給負責的人。
重現步驟用序號串起來
文字寫「先點右上角、再選第二項、再按確定」,讀者要在心裡把三句話和畫面對應起來。改成在圖上放 1、2、3,這個對應就免費了。
兩個要注意的地方。第一,如果每一步之後畫面會改變(點了之後跳出新視窗),那就不能在同一張圖上標 1、2、3——那張圖畫的是一個不存在的畫面。這種情況要一步一張圖。第二,如果你事後刪掉了中間某一步,圖上的號碼必須跟著往前遞補;畫面上從 1 跳到 3,看的人會停下來找那個不存在的 2,而他找的時間本來可以拿去修問題。
一個好用的搭配是:截圖的序號,和你在描述欄裡寫的步驟編號,用同一組數字。這樣對方讀到第三步覺得奇怪,直接去圖上找 3 就好。
什麼時候該錄影而不是截圖
當問題是「動作」而不是「狀態」的時候。動畫卡頓、捲動時破圖、按下去沒反應、順序錯亂——這些截圖抓不到。iPhone 的螢幕錄影在控制中心,Mac 上按 Shift-Command-5 就有。
但錄影有代價:它不能被標註得那麼精確,讀的人要花二十秒看完而不是兩秒,而且它會把整段期間裡出現的所有東西一起錄進去,遮蔽困難得多。務實的做法是兩個都給——一段短影片證明現象,加一張標好的截圖指出關鍵那一格。
用 Marka 做這件事
這個流程在 Mac 上跑起來特別順,因為問題回報通常發生在電腦前。Control-Shift-Command-4 把畫面截進剪貼簿,貼進 Marka,按 m 用遮蔽筆刷把客戶姓名和權杖刷掉,按 n 放上重現步驟的序號,按 a 拉一支箭頭指住錯誤訊息,然後 Command-C 複製回剪貼簿,切回 Jira 或 Slack 貼上。中間不產生任何檔案,也就不會在桌面留下一疊還沒遮的截圖。
序號會在你刪掉其中一個之後自動重編,依據是建立順序而不是疊放層級——這正好對應到上面那個坑。線條粗細和序號大小是按影像短邊的比例算的,所以你截一整個 4K 螢幕,箭頭也不會細得像一根頭髮。Mac 上另外有「查找敏感資訊」,用系統的 Vision 框架在本機掃出電話、電子郵件、卡號式數字、人臉和網址,列成候選讓你勾選——把它放在你自己檢查過一遍之後跑,當作第二雙眼睛;它只建議、不代勞,而且一定會漏。這個功能只有 Mac 版有,也屬於 Pro。
免費可以用的是:開啟或貼上圖片、裁切與旋轉翻轉、馬賽克遮蔽筆刷、一百步還原,以及把結果複製出去或匯出。整個過程在你的電腦裡完成——沒有伺服器、沒有帳號、沒有埋點。對一張還沒遮的內部系統截圖來說,這件事不是附加價值,是前提。
常見問題
Bug 截圖要截整個視窗還是只截出錯的地方?
整個視窗。網址、分頁標題、側邊欄狀態、時間,這些都是縮小範圍的線索,裁掉之後就找不回來了。重點交給箭頭或框去指,不要交給裁切。真的太大就給整張加一張局部放大,兩張一起送。
截圖裡有客戶資料,但那正好是重現問題的關鍵,怎麼辦?
遮掉值、留下形狀:把姓名和編號蓋掉,但讓對方看得出那一欄存在、有幾筆、什麼格式。如果那個值本身就是關鍵,不要放進共用的追蹤系統,改用私訊給實際負責處理的人,並在單子上註明資料另外提供。
重現步驟可以全部標在同一張圖上嗎?
只有當這幾步都發生在同一個畫面上才可以。只要其中一步會讓畫面改變(跳出視窗、換頁),同一張圖上就不可能同時存在後面那幾步,那張圖畫的是一個不存在的畫面。這種情況要一步一張。
什麼時候該錄影?
當問題是動作而不是狀態的時候:卡頓、捲動破圖、按了沒反應、順序錯亂。截圖抓不到這些。但錄影不好標註也不好遮蔽,所以最好的組合是一段短影片加一張標好的關鍵截圖。
標好的圖怎麼最快貼進 Jira 或 Slack?
Mac 上用 Control-Shift-Command-4 把畫面截進剪貼簿,在 Marka 裡處理完之後複製回剪貼簿,切回去按 Command-V 就好。整個過程不產生檔案,桌面也不會累積一堆還沒遮的截圖。
用 Marka 來做
Marka 是 iPhone、iPad 與 Mac 上的截圖標註 App。劃一下把不該看的蓋掉,用箭頭指住該看的,用序號標出步驟,裁成你要發的比例,然後送出。全程在裝置本機處理——不上傳、免註冊、無追蹤,安裝檔 2.4 MB。開啟圖片、裁切、馬賽克筆刷與匯出都免費;Pro 是一次性買斷,三端通用。