IntelliJ IDEA에서 첫 프로젝트 만들기

1. 새 프로젝트를 단계별로 만들기

IntelliJ IDEA의 프로젝트는 단순한 파일 폴더가 아니라, IDE가 앞으로 만들 프로그램과 관련된 모든 것을 보관하는 컨테이너입니다. 프로젝트에는 다음이 포함됩니다:

• 소스 코드(.java 확장자를 가진 파일);
• 프로젝트 설정(예: 사용할 Java 버전);
• 외부 라이브러리(필요한 경우);
• 보조 파일과 리소스.

프로젝트 내부에는 보통 src 폴더가 있으며, Java 파일을 두는 기본 위치입니다. 코드와 관련 없는 것은 별도로 보관되어 작업을 방해하지 않습니다.

IntelliJ IDEA 시작하기

시작 화면에서 큰 파란색 버튼 New Project를 클릭합니다.

프로젝트 매개변수 설정

위에서 아래로 주요 필드를 하나씩 살펴보겠습니다:

• Name: 프로젝트 이름. 이 이름은 디스크에 폴더를 만들 때도 사용됩니다.
• Location: 프로젝트가 저장될 컴퓨터상의 경로. 기본값으로 IDEA는 IdeaProjects 폴더를 제안합니다. 그대로 두면 됩니다.
• Create Git repository: 프로젝트에 대해 Git 버전 관리 시스템을 즉시 초기화합니다. 이 단계에서는 복잡하게 만들지 않기 위해 체크하지 마세요.
• Build system: 빌드 시스템은 코드 컴파일, 의존성 관리, 실행 가능한 애플리케이션 생성 과정을 자동화하는 도구입니다:
  • IntelliJ: IDEA에 내장된 빌드 시스템. 우리의 선택.
  • Maven/Gradle: 강력한 독립형 빌드 시스템으로, 실제 프로젝트의 99%가 둘 중 하나를 사용합니다.
• Add sample code: IDEA가 기본 프로젝트 구조와 main 메서드를 가진 클래스를 자동으로 생성합니다.

IntelliJ IDEA에서 JDK 설치

이제 JDK를 설치할 차례입니다.

• 아직 설치하지 않았으므로 목록이 비어 있을 것입니다. 여기서 바로 다운로드하면 됩니다.

1. 드롭다운을 클릭하고 Download JDK... 옵션을 선택합니다.

2. 작은 창이 열립니다:

• Version: Java 버전 선택. 본 과정은 버전 25를 지원합니다.
• Vendor: 배포 공급자. 앞서 이야기한 대로 Amazon Corretto를 선택합니다.
• Location: IDEA가 이 JDK를 다운로드하고 설치할 경로. 기본값을 사용해도 됩니다.

3. Select 버튼을 누릅니다.

설정이 모두 완료되었습니다. Create를 클릭하세요.

IntelliJ IDEA는 선택한 JDK를 다운로드한 뒤 프로젝트 구조를 생성하고 에디터의 메인 창을 엽니다. 몇 분 정도 기다리면 됩니다.

첫 실행 시 오른쪽 하단에 IDE 성능에 영향을 줄 수 있는 백신 설정을 안내하는 알림이 나타날 수 있습니다(예: “Microsoft Defender may affect IDE performance”). Exclude folders 버튼을 눌러도 됩니다. IntelliJ IDEA가 프로젝트 폴더와 자체 시스템 폴더를 백신의 예외 목록에 자동으로 추가합니다.

프로그램을 처음 실행하면 Ultimate 무료 체험 기간 활성화를 알리는 배너가 표시됩니다. 이는 새로운 통합 버전인 IntelliJ IDEA의 표준 환영 메시지입니다.

이 알림은 현재 Ultimate에 임시로 액세스할 수 있음을 확인하는 것일 뿐이며, 우리 코스에서는 필수 사항이 아닙니다.

2. IDEA 간단 둘러보기

새 프로젝트를 만들었습니다. 화면에 보이는 요소들을 살펴봅시다.

1. Project: 프로젝트 구조를 탐색하는 기본 창.

2. 현재 열려 있는 파일 Main.java

3. 프로그램 실행을 위한 Run ▶ 버튼과 디버깅을 위한 Debug 버튼

4. 사이드 패널

• Services: 외부 서비스를 관리하는 탭으로, 초기에는 필요하지 않습니다.
• Terminal: IDE에 내장된 운영체제(Windows, macOS, Linux)의 명령줄(콘솔)입니다.
• Problems: 코드 작성 중에 컴파일 오류와 경고를 보여주는 패널입니다. IDEA는 코드를 실시간으로 분석하여 문제 부분을 밑줄로 표시하고, 종종 자동 수정 제안을 제공합니다.
• Git: 가지가 뻗은 다이어그램 모양의 아이콘. Git 버전 관리 기능을 위한 패널입니다.

3. 프로젝트 구조

이제 왼쪽의 프로젝트 구조 창을 자세히 봅시다. IntelliJ IDEA가 몇 가지 중요한 파일과 폴더를 만들어 두었습니다.

• .idea - IntelliJ IDEA의 내부용 폴더입니다. 이 프로젝트에만 해당하는 설정이 저장됩니다.
  이 폴더를 수동으로 수정하거나 다른 개발자에게 전달할 필요는 없습니다. 사용자별로 고유합니다.
• src - 모든 Java 프로젝트에서 가장 중요한 폴더입니다. 이름은 “sources”(소스)의 약자입니다. 여기에 여러분의 모든 코드가 들어갑니다.
  • Main.java — “Add sample code” 옵션을 체크했기 때문에 IDEA가 이 파일을 생성했습니다. 프로그램의 “진입점”인 메서드 public static void main(String[] args)를 가진 Java 클래스입니다. 모든 Java 프로그램은 여기서부터 실행됩니다.
• .gitignore - Git 버전 관리 시스템을 위한 구성 파일입니다.
• External Libraries - 실제 폴더가 아니라, 프로젝트에 연결된 모든 외부 라이브러리를 가상으로 보여주는 항목입니다. 현재는 하나만 있지만 가장 중요한 라이브러리 — 바로 우리의 JDK가 있습니다.

4. 프로그램 실행

가장 즐거운 순간은 프로그램을 실행해 자신의 노력이 만든 결과를 확인하는 것입니다(오류만 보는 게 아니라!).

창 상단에서 Run ▶ 버튼을 클릭하세요. 그 왼쪽에는 실행될 파일 이름이 표시됩니다(우리의 경우 Current File):

대안: 파일을 우클릭하고 ▶ Run Run 'Main.main()'.

프로그램 실행 결과가 표시됩니다

실행 명령(빨간색) — IntelliJ IDEA가 프로그램 실행을 위해 운영체제에 전달한 명령입니다.

이는 우리가 다운로드한 그 JDK의 실행 파일 java.exe를 직접 호출한 것입니다. 이 파일이 Java 가상 머신(JVM)을 시작합니다. java.exe 뒤의 나머지 문자열은 모두 내부용 매개변수입니다.

프로그램 출력(파란색)은 여러분의 코드가 만들어 낸 유용한 결과입니다.

종료 코드(초록색) Process finished with exit code 0. 이 메시지는 프로그램이 어떻게 종료되었는지에 대한 최종 보고입니다.

• 관례적으로 exit code 0은 프로그램이 처음부터 끝까지 정상적으로 실행되어 오류 없이 종료되었음을 의미합니다.
• 그 외의 모든 코드는 실행 중 오류가 발생했음을 알립니다.

항상 이 줄을 확인하세요. 이 줄이 프로그램이 “죽었는지” 또는 정상 종료했는지 알려 주는 핵심 지표입니다.

또한 첫 실행 후 왼쪽 프로젝트 구조에 새 폴더 out이 생깁니다. 그 안에는 컴파일된 .class 파일 — 즉 JVM이 실행하는 바이트코드가 들어 있습니다.

축하합니다! 전문 IDE에서 Java로 첫 프로그램을 작성하고 실행했습니다.

IDEA에서 프로그램 실행은 이렇게 동작합니다

여러분이 Run을 누르면 다음이 일어납니다:

1. IDEA가 코드를 컴파일 — .java를 .class(JVM용 바이트코드)로 변환합니다.
2. JVM이 시작 — Java 가상 머신이 main 메서드부터 프로그램을 실행합니다.
3. 결과 출력 — System.out.println으로 출력한 모든 내용이 콘솔에 나타납니다.

이 모든 마법이 몇 번의 클릭으로 이뤄집니다 — 컴파일러를 직접 호출하거나 저장 위치를 찾을 필요가 없습니다.

5. IntelliJ IDEA keyboard shortcuts

IntelliJ IDEA에는 편집, 내비게이션, 리팩터링, 디버깅 등 대부분의 명령에 대한 단축키가 있습니다. 이 단축키를 익히면 키보드에서 손을 떼지 않고도 생산성을 높일 수 있습니다.

단축키 조합은 운영체제별로 선택해 JetBrains 문서에서 확인할 수 있습니다.

또는 IDEA 내에서 확인할 수 있습니다. Menu-Help-Keyboard shortcuts PDF.

6. 첫 프로젝트에서 자주 하는 실수

src 폴더 밖에 Java 파일을 만들었다

Java 세계에는 확고한 규칙이 있습니다. src 폴더가 프로젝트 소스의 루트입니다. IDE와 빌드 시스템은 그 위치에서 코드를 찾을 것으로 기대합니다.

클래스 이름과 파일 이름 불일치
파일 이름은 클래스 이름과 동일해야 합니다(대소문자 구분!). 예를 들어 Main 클래스의 파일은 Main.java입니다. 파일을 main.java(소문자 m)로 만들면 컴파일러가 불평합니다.

main 메서드가 누락되었거나 잘못 작성됨
메서드는 정확히 public static void main(String[] args)이어야 합니다. 오타 하나만 있어도 프로그램은 실행되지 않습니다.

프로젝트에 JDK를 선택하지 않음
프로젝트 생성 시 JDK를 선택하지 않았거나 경로를 잘못 지정하면 IDEA가 프로젝트를 컴파일할 수 없습니다. File → Project Structure → Project SDK에서 설정을 확인하세요.

경로의 공백과 키릴 문자
최신 시스템은 훨씬 관대해졌지만, 황금률은 여전히 유효합니다. 프로젝트와 JDK의 경로에는 키릴 문자, 공백 또는 특수 기호를 포함하지 않는 것이 좋습니다. 라틴 문자와 밑줄만 사용하는 것이 좋습니다.

잘못된 클래스를 실행
여러 개의 클래스에 main 메서드가 있다면, 우클릭 → ▶ Run을 통해 올바른 파일을 실행하고 있는지 확인하세요.