맥에서 버그 제보용 스크린샷 찍기: 재현 단계와 작성 템플릿

문제가 생긴 화면만 보내면 몇 가지 질문이 남아요. 어떤 동작을 했는지, 원래는 어떻게 되어야 하는지, 매번 발생하는지 알기 어렵거든요. 필요한 부분을 담은 캡처에 짧은 설명을 붙이면 조사하는 사람이 문제를 재현하기 쉬워져요.

맥 앱이나 웹사이트의 오류를 제보할 때 쓸 수 있는 흐름을 정리했어요. 이슈 트래커나 고객지원 메시지에 복사해서 쓸 템플릿도 있어요.

1. 문제가 발생한 맥락까지 담기

가능하면 문제가 생긴 버튼과 결과를 한 화면에 담으세요. 저장 버튼을 눌렀을 때 오류가 뜬다면 버튼, 오류 문구, 관련 입력 영역이 함께 보이는 편이 좋아요. 전체 바탕화면을 찍으면 세부 내용이 작아지고, 오류 문구만 잘라내면 어느 화면의 문제인지 알기 어려워요.

재현할 때는 샘플 데이터를 사용하세요. 관련 없는 탭이나 계정 정보는 캡처 범위에서 빼면 돼요. 인증 정보나 비공개 값은 캡처하기 전에 원본에서 제거하는 편이 좋아요. 약한 블러만으로 글자가 확실히 지워진다고 볼 수는 없어요.

Floatie의 영역 캡처로 결과를 띄워두면 앱으로 돌아가 재현 단계를 확인할 때 참고할 수 있어요. 설명에 다른 상태가 필요하면 그 장면을 한 장 더 찍으세요.

2. 관찰한 부분에 표시하고 설명 붙이기

문제가 있는 버튼을 가리키는 화살표 하나면 충분할 때가 많아요. 순서를 따라가야 할 때만 번호를 넣고, 자세한 설명은 첨부 옆의 본문에 적으세요. 정확한 오류 문구나 문제를 보여주는 숫자 위에는 표시를 겹치지 않는 게 좋아요.

Floatie 조각이 활성화된 상태에서 ⌘E를 누르면 Pro 편집기가 열려요. 화살표, 텍스트, 번호 표시를 넣을 수 있어요. 도구 구성은 편집기 기능 안내에서 확인할 수 있어요.

직접 해보세요

청구서 #2041 PAID

청구 대상Jane Doe

Emailjane.doe@example.com

Card•••• 4242

합계$1,240.00

메모

금요일까지 배송.

카드 정보 등록됨 — 다시 보내지 말 것.

도구를 고르고 조각 위에 그려 보세요

오류가 이미지로만 남아 있다면 OCR로 문구를 복사할 수 있어요. 복사한 결과는 원본과 대조하세요. 특히 문장부호나 모양이 비슷한 문자는 확인하는 편이 좋아요. 오류 문구를 본문에도 적어두면 상대가 검색하거나 복사하기 쉬워져요.

3. 재현 단계 템플릿 붙여넣기

아래는 설명을 위한 가상 사례예요. 실제 관찰한 내용으로 바꿔서 사용하세요.

제목: 프로젝트 이름을 입력해도 저장 버튼이 비활성 상태로 남음

환경:
- 앱 이름과 버전:
- macOS 버전:
- 브라우저와 버전(웹사이트 문제일 때):

재현 단계:
1. 새 프로젝트를 연다.
2. 이름을 입력한다.
3. 저장 버튼을 눌러본다.

기대한 결과: 유효한 이름을 입력하면 저장할 수 있다.
실제 결과: 저장 버튼이 비활성 상태로 남는다.
발생 빈도: 3번 시도해 3번 발생했다.
첨부: project-save-disabled.png

발생 빈도는 실제로 확인한 횟수로 바꾸세요. 한 번만 겪었다면 한 번이라고 적으면 돼요. 웹사이트의 배치 문제라면 창 크기나 확대 비율에 따라 달라지는지도 함께 적어주면 도움이 돼요.

4. 스크린샷과 녹화 중 고르기

잘못된 값, 빠진 문구, 깨진 배치는 스크린샷으로 보여주기 좋아요. 사라지는 메뉴나 예상과 다른 스크롤, 여러 번의 클릭이 필요한 문제라면 짧은 녹화가 더 알맞아요. 관련 영역만 녹화하고 동작이 드러나면 끝내세요.

제보와 함께 오래 보관해야 한다면 이슈에 파일을 직접 첨부하세요. 전송 전 첨부파일을 열어 중요한 글자가 읽히는지 확인하면 좋아요. 용량 제한이 있다면 핵심 내용을 유지하면서 스크린샷 크기를 줄이는 방법을 적용해 보세요.

Floatie로 버그 제보 준비하기