코드 리뷰 체크리스트 (Code Review Checklist)
고품질의 코드를 유지하기 위해 코드 리뷰 시 반드시 확인해야 할 항목들을 정리한 체크리스트입니다.
코드 리뷰 체크리스트
효과적인 코드 리뷰를 위해 아래 항목들을 점검해 주세요. 리뷰어와 작성자 모두가 참고할 수 있습니다.
1. 기능 및 로직 (Functionality)
- 요구사항에 맞게 기능이 정확히 구현되었는가?
- 엣지 케이스(Edge Cases) 및 예외 처리가 되어 있는가? (예: null, 빈 값, 타임아웃)
- 비즈니스 로직에 결함이나 잠재적인 버그가 없는가?
2. 코드 가독성 및 스타일 (Readability)
- 변수명, 함수명이 그 역할을 명확히 설명하고 있는가?
- 함수/메서드가 너무 길지 않고 하나의 역할만 수행하는가?
- 코딩 컨벤션(Lint 규칙 등)을 준수하고 있는가?
- 주석이 필요한 곳에 적절히 작성되었는가? (코드 자체로 설명 가능하다면 지양)
3. 보안 및 성능 (Security & Performance)
- 민감한 정보(API Key, 비밀번호 등)가 코드에 노출되지 않았는가?
- SQL Injection, XSS 등 기본적인 보안 취약점이 없는가?
- 불필요하게 복잡한 루프나 메모리 낭비가 발생하는 구간은 없는가?
- 데이터베이스 쿼리가 효율적이며 인덱스를 활용하는가?
4. 테스트 (Testing)
- 단위 테스트(Unit Test)가 추가되었으며, 성공적으로 통과하는가?
- 테스트 코드가 실제 기능의 시나리오를 충분히 커버하는가?
- Mocking이 적절하게 사용되었는가?
5. 아키텍처 및 설계
- 중복 코드가 발생하지 않았으며 재사용 가능한 구조인가?
- 의존성 주입 등이 올바르게 적용되어 결합도가 낮은가?
- 기존 아키텍처 패턴(예: Layered Architecture)과 일관성이 있는가?
리뷰 매너: “왜 이렇게 작성했나요?” 보다는 “이 부분을 이렇게 고치면 ~한 장점이 있을 것 같은데 어떻게 생각하시나요?”와 같은 건설적인 피드백을 지향합니다.