개발 · 현업 이해
코드 리뷰에서 신입 코드가 자주 지적받는 부분
신입 프로그래머가 팀에 들어가 처음 맡은 작업을 올리면, 하루 이틀 사이에 선배들의 리뷰 댓글이 줄줄이 달립니다. 기능은 잘 돌아가는데 왜 이렇게 많은 지적이 붙는지 당황스럽지만, 그 댓글들은 대부분 비슷한 몇 가지 유형으로 묶입니다. 코드 리뷰가 팀 안에서 어떤 역할을 하는지와 자주 나오는 지적을 미리 알아 두면 첫 리뷰를 훨씬 편하게 맞을 수 있습니다.
작업 노트 427 · 읽는 시간 약 5분 · 2026.11.17 정리
코드 리뷰가 팀 작업 흐름에서 놓인 자리
많은 개발팀은 각자 맡은 기능을 별도의 작업 가지에서 만든 뒤, 공용 코드에 합치기 전에 다른 사람이 읽어 보는 과정을 거칩니다. 이 확인 과정을 코드 리뷰라고 부릅니다. 작업자는 무엇을 왜 바꿨는지 설명을 붙여 요청을 올리고, 리뷰어는 코드를 읽으며 질문이나 수정 제안을 댓글로 남깁니다. 승인이 나야 공용 코드에 합쳐집니다.
리뷰의 목적은 버그를 잡는 것만이 아닙니다. 팀 전체가 같은 규칙으로 코드를 쓰게 맞추고, 한 사람만 아는 코드를 줄이는 역할도 합니다. 어떤 기능을 만든 사람이 휴가를 가도 리뷰를 거친 코드라면 다른 사람이 이어서 고칠 수 있습니다. 그래서 리뷰 댓글은 개인 평가라기보다 팀이 함께 읽을 수 있는 코드를 만드는 대화에 가깝습니다.
게임팀에서는 프로그래머끼리만 리뷰를 주고받지 않습니다. 기획자가 만든 데이터 표를 읽는 코드라면 기획 의도와 맞는지 확인이 필요하고, 아티스트가 쓰는 도구를 고쳤다면 사용 방식이 바뀌는지 알려야 합니다. 리뷰 설명에 무엇이 바뀌고 누구에게 영향을 주는지 적는 습관은 이런 협업을 매끄럽게 합니다.
이름과 구조에서 가장 먼저 붙는 댓글
신입 코드에서 가장 흔한 지적은 이름입니다. temp, data2, flag 같은 이름은 작성자에게는 분명해도 읽는 사람에게는 수수께끼입니다. 플레이어가 무적 상태인지 나타내는 변수라면 이름만 보고도 그 뜻이 드러나야 합니다. 팀마다 정해 둔 이름 규칙이 있으니 첫 주에 기존 코드를 읽으며 규칙부터 익히는 것이 좋습니다.
다음은 한 함수가 너무 많은 일을 하는 경우입니다. 플레이어 업데이트 함수 하나에 입력 처리, 이동, 공격, UI 갱신, 사운드 재생까지 몰려 있으면 수백 줄이 되고, 한 부분을 고칠 때 다른 부분이 깨지기 쉽습니다. 리뷰어는 보통 역할별로 함수를 나누라고 제안합니다. 나누고 나면 각 함수 이름이 곧 설명이 됩니다.
숫자를 코드에 그대로 박아 두는 것도 자주 지적받습니다. 이동 속도 5.5, 체력 100, 쿨다운 0.8 같은 값이 코드 곳곳에 흩어져 있으면 기획자가 수치를 바꿀 때마다 프로그래머가 코드를 고쳐야 합니다. 이런 값은 이름 붙인 상수나 데이터 파일로 빼 두는 것이 기본입니다. 기획 쪽과 협업이 쉬워지는 효과도 있습니다.

게임 코드라서 더 자주 보이는 지적
매 프레임 실행되는 코드에서 불필요한 작업을 하는 것도 단골 지적입니다. 매 프레임 이름으로 오브젝트를 찾거나 새 객체를 만들고 버리는 코드는 당장은 문제없어 보여도 대상이 많아지면 성능을 깎아 먹습니다. 리뷰어는 결과를 한 번 저장해 두거나, 값이 바뀔 때만 실행하도록 바꾸라고 제안하는 경우가 많습니다.
예외 상황을 생각하지 않은 코드도 자주 걸립니다. 대상이 이미 사라졌는데 접근하거나, 목록이 비어 있는데 첫 항목을 꺼내려는 경우입니다. 게임에서는 적이 죽는 순간과 공격이 닿는 순간이 겹치는 일이 흔해서, 이런 빈틈이 플레이 중 멈춤으로 이어집니다. 접근 전에 대상이 유효한지 확인하는 습관이 필요합니다.
디버그용 코드를 그대로 남기는 것도 흔합니다. 테스트하려고 넣은 로그 출력, 임시로 막아 둔 코드, 무적 치트가 리뷰 요청에 섞여 올라오는 경우입니다. 요청을 올리기 전에 바뀐 부분 전체를 한 번 훑어보며 이번 작업과 상관없는 변경이 섞이지 않았는지 확인하면 리뷰어의 시간을 아낄 수 있습니다.
리뷰 요청을 올리는 방식에서 나오는 지적
한 번에 너무 많은 변경을 올리는 것도 문제입니다. 수십 개 파일이 바뀐 요청은 리뷰어가 꼼꼼히 보기 어렵고, 결국 중요한 문제를 놓칠 수 있습니다. 기능을 작은 단위로 나눠 여러 번 올리면 각 리뷰가 빨리 끝나고, 문제가 생겨도 어느 변경에서 시작됐는지 찾기 쉽습니다.
설명 없는 요청도 지적을 받습니다. 무엇을 바꿨는지, 왜 이 방식을 골랐는지, 어떻게 확인했는지를 몇 줄로 적어야 합니다. 화면이 바뀌는 작업이라면 전후 캡처나 짧은 영상을 붙이면 리뷰어가 코드를 읽기 전에 의도를 이해할 수 있습니다. 확인 방법을 적어 두면 리뷰어가 같은 테스트를 다시 해 볼 수도 있습니다.
리뷰 댓글에 답하는 태도도 중요합니다. 지적을 반영했다면 어떻게 고쳤는지 짧게 남기고, 다른 의견이 있다면 이유를 들어 설명합니다. 이해가 안 되는 댓글은 그냥 넘기지 말고 질문하는 편이 낫습니다. 리뷰는 서로 배우는 자리라, 신입의 질문이 팀 규칙을 다시 정리하는 계기가 되기도 합니다.

입사 전에 미리 들여 둘 수 있는 습관
혼자 공부할 때도 리뷰를 흉내 낼 수 있습니다. 기능을 하나 만들면 하루 뒤에 처음 보는 사람이라고 생각하고 다시 읽어 봅니다. 이름이 뜻을 말해 주는지, 함수가 한 가지 일만 하는지, 숫자가 코드에 박혀 있지 않은지 이 글의 항목대로 점검합니다. 스스로 찾은 문제를 고친 기록도 남겨 둡니다.
친구나 스터디원과 서로의 코드를 바꿔 읽는 것도 좋은 연습입니다. 처음에는 댓글을 다는 것도 받는 것도 어색하지만, 몇 번 하다 보면 내 코드에서 어떤 부분이 남에게 읽히기 어려운지 감이 옵니다. 버전 관리 도구로 작업 가지를 나누고 합치는 흐름까지 같이 연습하면 실제 팀 작업에 훨씬 빨리 적응합니다.
이런 습관은 포트폴리오 코드에서도 그대로 드러납니다. 면접관은 소스 코드를 열어 이름, 구조, 주석의 상태를 보고 함께 일하기 좋은 사람인지 가늠합니다. SBS아카데미게임학원 게임프로그래밍 과정의 팀 프로젝트에서 이런 협업 흐름을 경험해 보고 싶다면, 무료 상담에서 지금 코드 수준과 목표를 이야기해 보세요.
자주 묻는 질문
리뷰 댓글이 너무 많이 달리면 실력이 부족하다는 뜻인가요?
신입 시기에는 팀 규칙에 익숙하지 않아 댓글이 많은 것이 보통입니다. 같은 지적이 반복되지 않도록 기록하고 고치면 횟수는 자연스럽게 줄어듭니다.
주석은 많이 달수록 좋은가요?
코드가 무엇을 하는지는 이름과 구조로 드러내고, 주석은 왜 이렇게 했는지를 적는 데 쓰는 편이 좋습니다. 코드와 맞지 않는 오래된 주석은 오히려 혼란을 줍니다.

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.
과정 보기 →