오류 문구와 발생 조건을 함께 적습니다
같은 문구가 나와도 사용하는 버전과 실행 환경에 따라 원인이 다를 수 있습니다. 먼저 언제 어떤 작업에서 문제가 생겼는지 적고 오류 메시지의 핵심 부분을 기록하세요. 개인 경로나 인증 값이 포함돼 있다면 공개 검색 전에 제외합니다.
주소제트의 이 글은 특정 프로그램의 버그를 해결하는 정답이 아닙니다. 검색한 해결책이 자신의 문제에 적용되는지 판단할 근거를 모으는 순서입니다.
공식 문서와 프로젝트 이슈를 나누어 찾습니다
공식 문서는 기능의 의도와 사용 방법을 설명하고, 프로젝트 이슈에는 보고된 문제와 논의가 남을 수 있습니다. 검색 결과에서 어느 종류의 자료를 보고 있는지 표시하세요.
GitHub의 이슈 검색 안내에는 저장소와 상태 등으로 범위를 좁히는 방법이 나옵니다. 먼저 관련 프로젝트의 결과인지 확인하고 문구가 같다는 이유만으로 무관한 저장소의 수정안을 가져오지 않습니다.
해결됐다는 댓글의 적용 버전을 확인합니다
이슈가 닫혀 있어도 자신의 설치 버전에서 해결됐는지는 별개입니다. 논의에 나온 변경 사항과 현재 문서, 릴리스 안내를 대조하고 어떤 조건에서 확인된 해결책인지 읽으세요.
오래된 답변을 최신 방법처럼 적용하거나, 한 사용자의 우회 설정을 공식 권장 방식으로 소개하지 않습니다. 특히 보안 설정을 약하게 만드는 조치는 문제의 일반 해결책으로 삼지 않습니다.
| 근거 | 확인 질문 | 기록 |
|---|---|---|
| 오류 메시지 | 어느 작업에서 발생했나 | 핵심 문구 |
| 환경 | 버전·운영체제가 같은가 | 내 조건 |
| 이슈 상태 | 어떤 변경으로 닫혔나 | 적용 범위 |
| 시험 결과 | 같은 입력에서 재현되나 | 변경 전후 |
가상 사례: 같은 오류, 다른 실행 환경
가상의 프로젝트 A는 특정 버전에서 파일 읽기 오류가 나고, 검색한 이슈 B는 다른 운영체제에서 권한 문제를 다룬다고 합시다. 문구가 같아도 파일 위치와 버전, 실행 계정 등의 조건이 다르므로 동일 원인으로 묶지 않습니다.
먼저 자신이 재현할 수 있는 작은 입력을 만들고 어떤 조건에서 실패하는지 확인합니다. 이 과정에서 얻은 관찰과 다른 사람의 설명을 분리해 메모합니다.
변경은 하나씩 적용하고 결과를 남깁니다
여러 해결책을 한꺼번에 적용하면 무엇이 영향을 줬는지 알기 어렵습니다. 원래 상태를 보관하고 한 번에 하나의 변경을 시험해 실패가 재현되는지 확인하세요.
정상 동작을 확인했다면 같은 입력뿐 아니라 원래 필요한 작업도 되는지 봅니다. 오류가 사라진 것과 기능이 의도대로 작동하는 것은 별도 검증 항목입니다.
찾은 링크는 해결 기록으로 묶습니다
최종 메모에는 사용한 버전, 재현 조건, 참고 문서, 적용한 변경과 결과를 남깁니다. 읽지 않은 댓글이나 다른 환경의 주장을 자신의 검증 결과처럼 적지 않습니다.
주소제트에서 공식 문서의 시작점을 찾고 문제별 기록에는 정확한 이슈와 관련 문서 주소를 연결하세요. 다음에 같은 오류가 나타났을 때 검색을 처음부터 반복하는 대신 조건이 바뀌었는지 비교할 수 있습니다.