동료의 코드리뷰가 두렵지 않게

Paul Evans

면접 준비를 시작하는 주니어 개발자라면 누구나 ‘이력서에 적을 프로젝트가 부족하다’는 압박감을 먼저 느낀다. 그래서 빠르게 무언가를 만들어내는 데만 집중하느라, 정작 그 코드가 다른 사람의 눈에는 어떻게 보일지 고민할 겨를이 없다. 그런데 정작 면접장에서 코드 리뷰를 진행하거나, 사전 과제를 평가하는 시니어 개발자들은 지원자의 화려한 기능 구현보다 훨씬 더 기본적인 부분을 먼저 본다. 왜 많은 주니어 개발자가 이 사실을 간과하고, 동료의 코드리뷰를 두려워하게 되는 걸까? 지금 이 순간, 당신이 작성하는 코드 한 줄 한 줄이 단순한 동작의 구현을 넘어 커뮤니케이션의 도구로 읽히고 있다는 점을 깨닫는 것이 중요하다.

코드리뷰에 대한 두려움은 대부분 ‘내 코드가 평가받는다’는 심리적 부담감에서 출발한다. 하지만 실제 회사 동료들이 코드 리뷰를 할 때 가장 먼저 발견하는 것은 논리적 오류나 예외 처리의 누락만이 아니다. 대부분의 경우, 함수명이 모호하거나, 한 함수가 너무 많은 일을 하고 있거나, 매직 넘버가 그대로 박혀 있어 왜 그 값이 사용되었는지 전혀 유추할 수 없는 상황이 가장 많이 지적된다. 문제는 이러한 지적들이 ‘기능이 잘못됐다’는 질책이 아니라 ‘읽는 사람이 이해하지 못하겠다’는 소통의 부재에서 발생한다는 점이다. 즉, 코드리뷰에 대한 두려움의 실체는 기술력 부족이 아니라, 상대방의 관점을 고려하지 않은 표현 방식의 미숙함일 때가 훨씬 많다.

이를 해결하기 위한 첫 번째 접근은 프로젝트의 규모를 떠나 ‘가독성’을 최우선 기준으로 삼는 습관을 기르는 것이다. 초보 개발자를 위한 첫 프로젝트를 진행할 때, 단순히 작동하는 코드를 짜는 것에 만족하지 말고, 그 코드를 3개월 후의 내가 다시 읽었을 때 혹은 전혀 맥락을 모르는 동료가 읽었을 때를 상상해야 한다. 예를 들어 커피숍 주문 관리 프로그램을 만든다고 가정해 보자. 주문 수량에 따라 할인율을 적용하는 로직이 필요하다면, 단순히 숫자 0.1을 직접 곱하는 대신 그 0.1이 무엇을 의미하는지 변수로 추출해야 한다. 비록 면접관이 그 코드를 모두 읽지는 않을지라도, 이러한 사소한 습관들이 코드 리뷰 과정에서 ‘의사소통이 잘 되는 사람’이라는 강력한 인상을 남긴다. 이는 개발자 포트폴리오 작성 팁에서 항상 강조되는 ‘의도가 드러나는 코드’와도 맞닿아 있는 부분이며, 프로젝트 구현보다 더 높은 점수를 받을 수 있는 요소다.

두 번째로, 개발자 면접 대비 전략 측면에서 바라볼 때, 코드 리뷰는 방어가 아니라 학습의 기회로 접근해야 한다. 동료가 코드의 문제점을 지적했을 때, 그 지적이 옳고 그름을 떠나 일단 그 사람이 코드를 읽으며 느꼈을 혼란의 지점을 파악하는 것이 더 중요하다. 많은 주니어 개발자가 ‘내 코드의 오류’라는 생각에 방어적으로 반응하지만, 실제로는 ‘설명이 부족했던 부분’이 어디인지 발견하는 과정인 것이다. 주석을 다는 것보다, 변수명을 더 명확하게 짓는 것보다, 코드의 구조 자체를 바꾸는 것이 리뷰어의 질문을 줄이는 가장 확실한 방법이라는 점을 기억해야 한다. IT 자격증 준비 과정에서 배운 이론적 지식이 실제 코딩 스타일에 적용되지 않는다면, 면접장에서 아무리 많은 기술 스택을 언급해도 그 진정성은 의심받기 쉽다. 프로그래밍 언어 선택 요령에서 어떤 언어를 고르든, 그 언어의 관용적 표현을 존중하고 팀의 컨벤션을 따르려는 자세가 코드리뷰에서의 마찰을 획기적으로 줄여준다.

결국 코드리뷰에 대한 두려움을 극복하는 것은 면접 합격을 위한 전략을 넘어, 개발자로서 성장하는 가장 빠른 지름길이다. 회사의 동료들은 단순히 버그를 찾기 위해 코드를 읽는 것이 아니라, 협업할 사람의 사고방식을 읽고 있다. 기능이 완벽하게 동작하는 코드는 실행 환경에서만 빛을 발하지만, 읽기 좋은 코드는 사람과 사람 사이에서 신뢰를 만든다. 면접관 앞에서 프로젝트를 설명할 때, 그리고 실제로 팀에 합류한 후 첫 코드리뷰를 받을 때, 당신의 코드가 논리적으로 완벽한지보다 오해 없이 읽히는지에 집중하라. 그러면 더 이상 코드리뷰는 두려운 평가의 장이 아니라, 당신의 성장을 도와주는 동료와의 대화로 자연스럽게 바뀌게 된다. 지금 작성하는 모든 코드 조각은 면접장에서 당신을 대신해 말해줄 가장 정직한 포트폴리오라는 사실을 잊지 말아야 한다.