초보 개발자를 위한 인텔리제이(IntelliJ) 필수 초기 설정 10단계: 야근을 줄이는 시니어의 IDE 최적화 가이드

인텔리제이(IntelliJ IDEA)를 처음 설치하고 기본 설정 상태 그대로 코딩을 시작하는 개발자들을 볼 때마다 솔직히 마음이 답답해집니다. 순정 상태의 인텔리제이는 겉보기엔 화려하지만, 실무 트래픽을 감당해야 하는 백엔드 개발자에게는 도처에 지뢰가 깔린 비효율의 극치이기 때문입니다. 메모리가 터져서 IDE가 굳어버리거나, 깃(Git) 커밋 한 번에 대소문자가 꼬여 서버가 뻗는 대참사를 겪고 나서야 "아, 설정 바꿀 걸" 하고 후회하면 이미 늦습니다.

초기 설정이 개발자의 수명을 결정하는 이유

많은 이들이 인텔리제이를 '단순히 코드 받아적는 메모장' 정도로 여깁니다. 큰 오산입니다. 인텔리제이는 수백 개의 클래스가 얽혀 있는 거대한 프로젝트의 추상화 인터페이스이자, 개발자의 뇌 용량을 보존해 주는 외부 연산 장치에 가깝습니다. 실무 환경에서는 대형마트 오픈런처럼 수많은 요청이 한꺼번에 몰리는 병목 구간을 잡아내야 하는데, 개발 환경 세팅이 엉망이면 로컬 디버깅 단계부터 삐걱거리게 됩니다. 초기 설정에 투자하는 10분은 향후 야근 100시간을 줄여주는 가장 가성비 높은 아키텍처 투자입니다.

1단계: 힙 메모리(Heap Memory) 증설 - 쾌적한 서핑의 시작

순정 인텔리제이의 최대 힙 메모리 설정은 고작 2GB 안팎입니다. 요즘처럼 스프링 부트(Spring Boot)에 마이크로서비스 수십 개를 띄우고, 로컬에서 Docker 인프라까지 연동하는 백엔드 환경에서는 2GB로 턱없이 부족합니다. 코드를 조금만 타이핑해도 인덱싱(Indexing)을 하느라 마우스 커서가 뱅글뱅글 돌면서 IDE가 멈추는 고속도로 병목 현상이 발생합니다. 생산성이 바닥을 치는 순간입니다.

 

반드시 상단 메뉴에서 [Help] -> [Change Memory Settings]로 이동해 최소 4GB(4096MiB) 이상으로 대역폭을 넓혀주십시오. 본인 PC 메모리가 32GB 이상이라면 8GB를 할당하는 것이 정신 건강에 이롭습니다. 가비지 컬렉터(GC)가 일하느라 IDE를 멈추는 빈도가 획기적으로 줄어듭니다.

인텔리제이 설정 - 생성형 ai 이미지

2단계: 대소문자 구분 안 함(Match Case 해제) - 타이핑 타이밍 사수

기본 상태에서는 코드 자동 완성을 쓸 때 대소문자를 정확히 맞춰야 제안 목록이 뜹니다. 예를 들어 String을 찾으려면 반드시 대문자 S를 쳐야 합니다. 소문자 s를 치면 멍청하게 가만히 있습니다. 1분 1초가 급한 장애 대응 상황에서 이런 사소한 제약은 개발자의 사고 흐름을 끊어먹는 주범입니다.

• 이동 경로: [Settings] -> [Editor] -> [General] -> [Code Completion]
• 수정 사항: 'Match case' 체크박스를 완전히 해제합니다.

이제 소문자로 대충 갈겨도 원하는 클래스와 메서드가 최상단에 스르륵 올라옵니다. 타이핑 속도가 체감상 2배는 빨라집니다.

3단계: 프로젝트 인코딩 UTF-8 고정 - 한글 깨짐 지옥 탈출

윈도우 환경에서 인텔리제이를 설치하면 기본 인코딩이 MS949 같은 해괴한 포맷으로 잡히곤 합니다. 이 상태로 코드를 짜서 리눅스 기반 운영 서버에 배포하면 로그 파일의 한글이 전부 깨져서 출력됩니다. 심지어 DB에 깨진 문자열이 그대로 박혀 데이터가 오염되는 대형 사고로 이어지기도 합니다.

 

[Settings] -> [Editor] -> [File Encodings]로 들어가서 Global Encoding, Project Encoding, Default encoding for properties files 세 가지 항목을 전부 **UTF-8**로 전환하십시오. 추가로 하단의 'Transparent native-to-ascii conversion' 체크박스도 켜주는 것이 좋습니다. 프로퍼티 파일의 다국어 처리가 꼬이는 현상을 예방해 줍니다.

4단계: Gradle 빌드 및 실행 프로세스 위임 변경

자바 백엔드 개발자라면 90% 이상 그레이들(Gradle)을 사용할 텐데, 인텔리제이는 기본적으로 프로젝트 빌드와 실행을 Gradle 래퍼를 거쳐서 수행하도록 세팅되어 있습니다. 안전하긴 하지만 느립니다. 코드를 한 줄 고치고 실행할 때마다 Gradle 데몬이 돌면서 불필요한 빌드 단계를 한 번 더 거치기 때문에 굼떠집니다.

 

[Settings] -> [Build, Execution, Deployment] -> [Build Tools] -> [Gradle] 경로로 이동합니다. 여기서 'Build and run using'과 'Run tests using' 항목을 기존 Gradle에서 **IntelliJ IDEA**로 변경하십시오. 내부 컴파일러를 직접 활용하기 때문에 단축키를 눌렀을 때 스프링 부트가 뜨는 속도가 눈에 띄게 민첩해집니다.

5단계: 자동 임포트(Auto Import) 활성화 - 무의미한 단축키 연타 금지

외부 라이브러리나 다른 패키지의 클래스를 가져올 때마다 일일이 빨간 줄을 보며 Alt + Enter를 누르는 짓은 비생산적입니다. 기계가 할 수 있는 일은 기계에게 전부 맡겨야 합니다.

 

[Settings] -> [Editor] -> [General] -> [Auto Import] 메뉴로 진입합니다. Java 항목 아래에 있는 'Add unambiguous imports on the fly'와 'Optimize imports on the fly' 두 가지 옵션을 체크하십시오. 코드를 복사해서 붙여넣거나 타이핑하는 순간 인텔리제이가 알아서 최적의 패키지를 임포트하고, 안 쓰는 임포트 구문은 실시간으로 정리해 줍니다. 코드 라인이 깔끔해지니 리뷰할 때도 편합니다.

6단계: 마우스 휠로 폰트 크기 조절(Zoom 기능)

동료와 페어 프로그래밍을 하거나 화면을 공유하며 코드 리뷰를 진행할 때, 폰트 크기가 고정되어 있으면 뒷사람은 코드가 보이지 않아 인상을 찌푸리게 됩니다. 그때마다 설정 창을 열어 폰트 크기 숫자를 바꾸는 행위는 촌스럽습니다.

 

[Settings] -> [Editor] -> [General] 탭 맨 위에 있는 'Change font size with Ctrl+Mouse Wheel in'을 활성화하십시오. 브라우저 창 크기를 조절하듯 컨트롤 키를 누른 채 마우스 휠을 돌리는 것만으로 코드 창의 스케일을 자유자재로 늘렸다 줄였다 할 수 있습니다. 사소하지만 발표나 공유가 잦은 시니어 개발자들에겐 필수적인 기능입니다.

7단계: 화이트 스페이스 및 메서드 구분선 표시 - 가독성 극대화

코드가 길어지면 어디가 A 메서드고 어디가 B 메서드인지 눈이 침침해집니다. 공백 문자(Space)와 탭(Tab)이 혼용되어 소스 코드가 지저분하게 꼬여도 눈에 잘 보이지 않습니다. 가독성은 버그와 직결되는 문제입니다.

 

[Settings] -> [Editor] -> [General] -> [Appearance] 메뉴에서 두 가지를 켜야 합니다. 'Show whitespaces'와 'Show method separators'입니다. 코드 사이에 은은한 점선으로 메서드 경계선이 생기고, 빈 공간이 점으로 표현되면서 코드의 구조적 짜임새가 한눈에 들어오게 됩니다. 포맷팅 룰이 깨진 구간을 본능적으로 감지할 수 있습니다.

8단계: Git 대소문자 무시 방지(Flycheck 설정)

윈도우나 맥 OS 환경에서는 파일명의 대소문자를 명확히 구별하지 않는 경우가 많습니다. 예컨대 UserOrder.java를 Userorder.java로 바꿔도 OS 레벨에선 같은 파일로 인식해 깃이 감지하지 못하곤 합니다. 이걸 그대로 리눅스 서버에 올리면? 리눅스는 대소문자를 칼같이 가리기 때문에 클래스를 찾지 못해 런타임 에러(ClassNotFoundException)가 터집니다.

 

인텔리제이 내부의 깃 터미널을 열고 다음 글로벌 명령어를 무조건 때려 박으십시오.

git config --global core.ignorecase false

이 설정을 세팅해 두어야만 로컬에서 변경한 파일명의 대소문자가 깃에 고스란히 추적되어 형상 관리 서버와 실 운영 서버 간의 정합성이 유지됩니다.

9단계: 플러그인 다이어트 - 무거운 도구는 과감히 쳐내라

초보자들은 인텔리제이 마켓플레이스에서 좋다는 플러그인을 이것저것 수십 개씩 설치합니다. 이 역시 IDE를 무겁게 만드는 지름길입니다. 화려한 테마, 불필요한 이모지 팩, 안 쓰는 언어 지원 도구들은 전부 백그라운드 스레드를 잡아먹는 좀비 프로세스입니다.

 

[Settings] -> [Plugins]에서 Installed 탭을 유심히 보십시오. 본인이 쓰지 않는 Android, Kotlin(순수 자바 백엔드일 경우), TOML, Space 등의 번들 플러그인은 과감하게 'Disable' 처리하십시오. 플러그인을 필요한 것 3~4개 빼고 다 끄는 것만으로도 인텔리제이 구동 속도가 30% 이상 개선됩니다. 꼭 필요한 건 롬복(Lombok)과 소나린트(SonarLint) 정도면 충분합니다.

10단계: 저장 시 자동 정렬(Actions on Save)

팀원들과 협업할 때 커밋 내역을 보면, 코드 한 줄 고쳤는데 파일 전체의 포맷팅이 바뀌어서 Diff가 수백 줄씩 뜨는 경우가 있습니다. 코드 스타일이 통일되지 않아서 그렇습니다. 리뷰어 입장에선 짜증이 솟구치는 순간입니다.

 

[Settings] -> [Tools] -> [Actions on Save]로 이동하십시오. 여기서 'Reformat code'와 'Optimize imports'를 체크해 둡니다. 이제 코딩을 마치고 Ctrl + S(저장)를 누를 때마다 수동으로 단축키를 누르지 않아도 코드가 정해진 규칙대로 칼같이 정렬됩니다. 정적 분석 도구에 걸려 빌드가 실패하는 허망한 실수를 원천 차단해 줍니다.

인텔리제이 유료 버전을 쓰면 정말 비용 대비 생산성이 나오나요?

커뮤니티 에디션(무료)과 얼티메이트 에디션(유료) 사이에서 고민하는 후배들이 많습니다. 결론부터 말하자면, 현업 백엔드 개발자라면 연간 라이선스 비용 수십만 원은 한 달 만에 뽑아내고도 남습니다.

기능 비교	커뮤니티 (무료)	얼티메이트 (유료)
스프링 부트 프로파일 연동	불가능 (수동 설정)	네이티브 지원
데이터베이스 툴 (Database Navigator)	미흡 (외부 툴 연동 필요)	DataGrip 내장 (최상급)
HTTP 클라이언트 (API 테스트)	지원 안 함	코드 기반 .http 제어

무료 버전을 쓰면 데이터베이스 보려고 디비버(DBeaver) 켜고, API 테스트하려고 포스트맨(Postman) 켜고, 스프링 설정 맞추려고 콘솔창 뒤져야 합니다. 컨텍스트 스위칭이 일어날 때마다 집중력이 흐려집니다. 얼티메이트 버전은 이 모든 툴을 IDE 창 하나로 통합해 줍니다. 툴 간 이동 속도가 줄어드는 것만으로도 야근 확률이 급격히 낮아집니다. 돈으로 시간을 사십시오.

결국 어떤 선택을 해야 하는가?

개발 환경 세팅에는 정답이 없다고들 하지만, 실무의 영역에서는 명백히 '틀린 세팅'이 존재합니다. 시스템의 자원을 효율적으로 쓰고, 실수를 방지하는 안전장치를 마련하는 일은 연차가 쌓일수록 더 뼈저리게 다가옵니다. 오늘 당장 본인의 인텔리제이 설정 창을 열어보십시오. 위에서 언급한 10가지 중 3개 이상이 기본 상태로 방치되어 있다면, 당신은 지금 엄청난 에너지를 길바닥에 버리며 코딩하고 있는 셈입니다. 도구에 지배당하지 말고, 도구를 100% 지배하는 개발자가 되기를 바랍니다.

VS Code 자바 Import 자동 정리 설정 및 와일드카드 오류 예방법

* 본 포스팅에 사용된 이미지는 생성형 AI를 통해 생성된 이미지입니다. *