M Marka 下載 Marka

問題回報用的截圖:留什麼、遮什麼、怎麼標

一張好的錯誤截圖要保留的東西,通常比回報者以為的多。這篇講該留什麼、該遮什麼,以及為什麼裁得太乾淨反而害了要修這個問題的人。

你遇到一個問題,要回報給工程師、客服或廠商。你截了圖、把出錯的那塊裁出來、畫了一個紅框,送出。三天後對方回你「可以提供完整畫面嗎」,然後那個畫面已經不存在了。這篇要講的就是怎麼一次就給對,以及為什麼「裁乾淨」在這個場合通常是幫倒忙。

核心的差別在這裡:社群上的截圖是給人看的,目標是把雜訊拿掉;問題回報的截圖是給人查的,目標是把線索留著。要修這個問題的人在意的東西,經常不是你圈起來的那一塊。

一張好的錯誤截圖要包含什麼

裁得太乾淨為什麼會害了對方

這是最常見也最花時間的失誤。你看到紅色的錯誤字串,很自然地把它裁出來——你以為你交出了重點,實際上你把周圍所有可以縮小範圍的資訊都丟了。

舉幾個真的發生過的形狀:錯誤訊息裁出來了,但網址被裁掉,對方不知道你在哪一頁;金額不對的那一行裁出來了,但上面的篩選條件被裁掉,而問題就出在篩選條件;App 當掉的畫面裁出來了,但狀態列被裁掉,於是沒人知道當時是不是沒有網路。

一條可以直接用的原則:先給整張,再用標註指出重點。留著背景不會讓對方看不懂——他有你的箭頭。裁掉背景才會讓他看不懂,因為那些資訊已經不在了。真的太大,就給整張加上一張放大的局部,兩張一起送。

進共用系統之前要遮掉什麼

這一節和上一節是互相拉扯的,必須同時處理。一張問題回報的截圖通常會進入某個共用的地方——Jira、Notion、共用資料夾、群組聊天——而那裡的可見範圍比你當下想的大得多,並且會留很久。

這裡有一個實務上的取捨:遮蔽會拿掉線索。做法是遮掉「值」,留下「形狀」——把客戶姓名蓋掉,但留著那一欄還在、留著它有幾筆;把訂單編號蓋掉,但在文字說明裡告訴對方那筆編號的前兩碼或它的格式。這樣對方知道結構,卻拿不到內容。如果那個值本身就是重現問題的關鍵,就不要放進共用系統,改用私訊給負責的人。

重現步驟用序號串起來

文字寫「先點右上角、再選第二項、再按確定」,讀者要在心裡把三句話和畫面對應起來。改成在圖上放 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 是一次性買斷,三端通用。

前往 App Store 下載

相關文章

全部文章