이 글의 핵심
오류 문구, 재현 순서, 환경, 수정 내역을 남겨 같은 문제를 반복하지 않는 개인 개발용 디버깅 기록법입니다.
오류 문구를 자르지 않는다
터미널의 마지막 한 줄만 복사하지 말고 최초 에러와 Caused by 같은 원인 구간을 함께 저장합니다. 빌드 오류는 위쪽의 첫 실패가 실제 원인이고 아래쪽 메시지는 연쇄 결과인 경우가 많습니다.
재현 순서를 적는다
예: flutter clean 후 실행, 실기기에서 특정 버튼을 두 번 누르면 종료처럼 어떤 행동 뒤에 문제가 생기는지 적습니다. 재현 단계가 명확하면 코드 수정 전후를 비교하기 쉽습니다.
환경 정보도 함께 기록
Flutter/Dart 버전, Android API, 기기 모델, 사용한 플러그인 버전을 같이 적습니다. 특히 Gradle, Kotlin, Android Gradle Plugin은 버전 조합에 영향을 받으므로 업그레이드 전후 기록이 중요합니다.
해결책과 되돌리기 방법
어떤 파일의 어느 설정을 바꿨는지, 다시 문제가 생기면 어떻게 원래대로 돌릴지까지 적습니다. 수정 전에 프로젝트를 압축하거나 Git 커밋을 남겨 두면 여러 파일을 바꾼 뒤 실패했을 때 안전하게 복구할 수 있습니다.