跳至正文

💻 IntelliJ IDEA 설치

📖 IntelliJ IDEA란?​

IntelliJ IDEA는 Kotlin을 만든 JetBrains가 개발한 최고의 Kotlin 개발 도구입니다. Kotlin은 IntelliJ IDEA에서 최고의 경험을 제공합니다!

🎯 왜 IntelliJ IDEA인가?​

IntelliJ IDEA의 장점:
├─ Kotlin 공식 IDE (JetBrains 제작)
├─ 최고의 Kotlin 지원
├─ 강력한 자동완성
├─ 실시간 오류 감지
├─ 리팩토링 도구
└─ 무료 버전(Community) 제공

VS Code와 비교​

VS Code:
├─ 가볍고 빠름
├─ 확장 프로그램 필요
└─ Kotlin 지원이 제한적

IntelliJ IDEA:
├─ Kotlin에 최적화
├─ 추가 설정 불필요
├─ 강력한 디버깅
└─ 추천! ⭐

📥 다운로드 및 설치​

1단계: 버전 선택​

IntelliJ IDEA는 두 가지 버전이 있습니다:

Community Edition (무료)
├─ Kotlin 개발에 충분
├─ 이 가이드에서 사용
└─ 추천! ✅

Ultimate Edition (유료)
├─ 웹 개발 도구 추가
├─ 데이터베이스 도구
├─ 학생은 무료
└─ 백엔드 개발자에게 추천

2단계: 다운로드​

  1. JetBrains 공식 사이트 접속
  2. 자신의 운영체제 선택 (Windows / macOS / Linux)
  3. Community Edition 다운로드 버튼 클릭
다운로드 크기:
├─ Windows: 약 700MB
├─ macOS: 약 800MB
└─ Linux: 약 700MB

3단계: 설치​

Windows​

1. 다운로드한 .exe 파일 실행
2. 설치 경로 선택 (기본값 추천)
3. 옵션 선택:
   ✅ Create Desktop Shortcut
   ✅ Add "bin" folder to PATH
   ✅ .kt 파일 연결
4. Install 클릭
5. 설치 완료 후 재부팅 (선택사항)

macOS​

1. 다운로드한 .dmg 파일 열기
2. IntelliJ IDEA 아이콘을 Applications 폴더로 드래그
3. Applications에서 IntelliJ IDEA 실행
4. "열기" 확인

Linux​

# Ubuntu/Debian
sudo snap install intellij-idea-community --classic

# Arch Linux
sudo pacman -S intellij-idea-community-edition

# 또는 공식 사이트에서 .tar.gz 다운로드
tar -xzf ideaIC-*.tar.gz
cd idea-IC-*/bin
./idea.sh

⚙️ 초기 설정​

1. 첫 실행​

IntelliJ IDEA를 처음 실행하면 설정 마법사가 나타납니다.

1. 이전 설정 가져오기
   → "Do not import settings" 선택 (처음이라면)

2. 테마 선택
   → Darcula (어두운 테마) 추천
   → Light (밝은 테마)

3. 키맵 선택
   → Default 추천
   → 이미 다른 IDE 사용 경험이 있다면 해당 IDE 선택

4. 플러그인
   → 기본 설정 그대로 진행

2. Kotlin 플러그인 확인​

IntelliJ IDEA Community는 Kotlin이 기본 탑재되어 있습니다!

확인 방법:
1. File → Settings (Windows/Linux)
   IntelliJ IDEA → Preferences (macOS)
2. Plugins 선택
3. "Kotlin" 검색
4. ✅ 설치됨(Installed)으로 표시되면 OK

3. JDK 설치 (필수!)​

Kotlin은 JVM에서 실행되므로 JDK가 필요합니다.

JDK 자동 다운로드 (추천)​

IntelliJ IDEA가 자동으로 JDK를 다운로드합니다:

1. 새 프로젝트 생성 시
2. "Add JDK" 클릭
3. "Download JDK" 선택
4. JDK 버전 선택: 17 또는 21 (LTS) 추천
5. Vendor: Amazon Corretto 또는 Oracle OpenJDK

JDK 수동 설치​

# Windows (Chocolatey)
choco install openjdk17

# macOS (Homebrew)
brew install openjdk@17

# Ubuntu/Debian
sudo apt install openjdk-17-jdk

# 설치 확인
java -version

🎨 유용한 설정​

한글 폰트 설정​

Settings → Editor → Font
├─ Font: D2Coding 또는 나눔고딕코딩
├─ Size: 14
└─ Line height: 1.2

자동 저장​

Settings → Appearance & Behavior → System Settings
✅ Save files automatically if application is idle for __ seconds
   → 15초 추천

자동 임포트​

Settings → Editor → General → Auto Import
✅ Add unambiguous imports on the fly (자동으로 import 추가)
✅ Optimize imports on the fly (사용하지 않는 import 제거)

코드 스타일​

Settings → Editor → Code Style → Kotlin
├─ Use default Kotlin style guide
└─ 들여쓰기: 4 spaces (기본값)

🔌 추천 플러그인​

기본 설치만으로 충분하지만, 유용한 플러그인들:

Rainbow Brackets​

여는 괄호와 닫는 괄호를 색깔로 구분

설치:
Settings → Plugins → Marketplace
→ "Rainbow Brackets" 검색 → Install

Key Promoter X​

마우스 대신 키보드 단축키를 배울 수 있게 도와줌

설치:
Settings → Plugins → Marketplace
→ "Key Promoter X" 검색 → Install

Material Theme UI​

더 예쁜 테마

설치:
Settings → Plugins → Marketplace
→ "Material Theme UI" 검색 → Install

⌨️ 필수 단축키​

Windows/Linux​

파일 관련:
Ctrl + N           - 클래스 찾기
Ctrl + Shift + N   - 파일 찾기
Ctrl + S           - 저장

편집:
Ctrl + D           - 줄 복사
Ctrl + Y           - 줄 삭제
Ctrl + /           - 주석 토글
Ctrl + Shift + /   - 블록 주석

코드:
Ctrl + Space       - 자동완성
Ctrl + Shift + Enter - 문장 완성
Alt + Enter        - Quick Fix
Ctrl + Alt + L     - 코드 정렬

실행:
Shift + F10        - 실행
Shift + F9         - 디버그

macOS​

파일 관련:
Cmd + O            - 클래스 찾기
Cmd + Shift + O    - 파일 찾기
Cmd + S            - 저장

편집:
Cmd + D            - 줄 복사
Cmd + Delete       - 줄 삭제
Cmd + /            - 주석 토글
Cmd + Shift + /    - 블록 주석

코드:
Ctrl + Space       - 자동완성
Cmd + Shift + Enter - 문장 완성
Opt + Enter        - Quick Fix
Cmd + Opt + L      - 코드 정렬

실행:
Ctrl + R           - 실행
Ctrl + D           - 디버그

🧪 설치 확인​

간단한 프로그램으로 설치를 확인해봅시다!

Kotlin Playground (온라인)​

설치가 부담스럽다면 온라인으로 먼저 시도:

https://play.kotlinlang.org/

장점:
├─ 설치 불필요
├─ 브라우저에서 즉시 실행
└─ 연습용으로 좋음

단점:
├─ 간단한 코드만 가능
└─ 프로젝트 생성 불가

IntelliJ에서 확인​

// File → New → Scratch File → Kotlin 선택
// 아래 코드 입력:

fun main() {
    println("Hello, Kotlin!")
    println("IntelliJ IDEA 설치 완료!")
}

// 실행: Ctrl + Shift + F10 (Windows/Linux)
//      Ctrl + Shift + R (macOS)

출력:

Hello, Kotlin!
IntelliJ IDEA 설치 완료!

🔧 문제 해결​

JDK를 찾을 수 없다는 오류​

해결 방법:
1. File → Project Structure
2. Project Settings → Project
3. SDK → Add SDK → Download JDK
4. JDK 17 또는 21 다운로드

Kotlin 플러그인이 없다는 오류​

해결 방법:
1. Settings → Plugins
2. Installed 탭에서 Kotlin 확인
3. 없다면 Marketplace에서 "Kotlin" 검색 및 설치
4. IntelliJ 재시작

한글이 깨진다​

해결 방법:
1. Settings → Editor → File Encodings
2. Global Encoding: UTF-8
3. Project Encoding: UTF-8
4. Default encoding for properties files: UTF-8

🎬 마치며​

IntelliJ IDEA 설치를 완료했습니다! 이제 Kotlin 개발 환경이 준비되었습니다.

완료한 것:
✅ IntelliJ IDEA Community 설치
✅ JDK 설치
✅ Kotlin 플러그인 확인
✅ 기본 설정
✅ Hello World 실행

다음 단계: Gradle 설정으로 프로젝트 빌드 도구를 알아봅시다!