JetBrains Rider에서 프로젝트 만들기

1. 소개

C# 개발에서는 코드가 그냥 파일들로 흩어져 있는 게 아니라, 항상 프로젝트로 묶여 있어. 프로젝트는 코드 파일, 설정, 외부 라이브러리 링크 등 중요한 것들을 담는 특별한 컨테이너야. 프로그램을 실행하거나 실행 파일로 빌드할 때, 이 프로젝트가 모든 걸 한데 모아주는 역할을 해.

프로젝트는 Solution 안에 들어가고, 하나의 솔루션에는 여러 프로젝트가 있을 수 있어 (예를 들어, 메인 앱 프로젝트 + 테스트용 별도 프로젝트).

2. Rider에서 새 프로젝트 만들기 단계별 가이드

1단계. 프로젝트 만들기

시작 화면에서 큰 파란색 "New Solution" 버튼을 눌러줘

템플릿 선택 창이 뜰 거야. 처음엔 "Console Application" (C#)을 만들 거야. 이게 연습 시작할 때 딱 좋아. UI나 웹서버 같은 복잡한 거 신경 안 써도 되고, 그냥 너랑 코드랑 콘솔만 있으면 돼.

오른쪽에서 프로젝트 세부정보를 입력해야 해:

• Solution Name: 네 "컨테이너" 이름. MyConsoleApp이라고 해줘.
• Project Name: 프로젝트 이름. Rider가 똑같이 제안할 거고, 그거 그대로 써도 돼.
• Location: 코드가 저장될 디스크 위치.
• Framework: .NET 버전 선택하는 곳인데, 최신 버전 그냥 두면 돼. 만약 네 컴퓨터에 필요한 .NET SDK가 없으면, Rider가 알아서 설치하라고 할 거야 — 그냥 확인 눌러주면 돼.
• Language: C#
• Do not use top-level statements: 이거 진짜 중요해! 꼭 체크해줘.

다 입력했으면 파란색 Create 버튼 눌러!

Rider가 프로젝트를 만들면, 이제 전통적인 C# 프로그램 구조로 코드를 쓸 거야. namespace, class, Main 같은 생소한 단어가 나와도 걱정 마 — 이건 모든 콘솔 프로그램의 기본 "블록"이야.

Windows Defender 알림. 안티바이러스가 Rider 파일 검사하느라 IDE가 느려질 수 있어. 속도 올리려면 IDE가 폴더를 예외로 추가하라고 할 거야. 그냥 대화창에서 허용해주면 돼.

3. 프로젝트 구조 익히기

코드 쓰기 전에, 화면 왼쪽을 봐봐 — 여기가 Solution Explorer 창이야. 이건 파일 탐색기랑 비슷한데, 그냥 파일만 보여주는 게 아니라 네 앱의 논리적 구조를 보여줘. 처음엔 몇 개만 보이지만, 각각이 뭔지 아는 게 중요해.

• MyConsoleApp (맨 위) - 네 솔루션(Solution), 아까 말한 "컨테이너"야.
• MyConsoleApp (안에 있는, C# 아이콘) - 네 프로젝트(Project). 여기에 네 프로그램 관련 파일이 다 들어있어.
• Dependencies (의존성) - 네 앱에 필요한 재료 리스트 같은 거야. 나중에 외부 라이브러리 추가하면 여기서 볼 수 있어.
• Program.cs - 메인 파일. C# 코드가 들어있는 텍스트 파일이야.

Solution Explorer에서 보는 건 논리적 구조고, 실제로 디스크의 프로젝트 폴더 구조는 좀 더 복잡해. 그래도 알아두면 좋아. Files 탭을 선택하면 이렇게 보여:

4. 코드 실행하기

프로젝트 실행: 초록색 ▶️ Run 버튼을 클릭해 (보통 창 위쪽 왼쪽에 있어 — 못 찾겠으면 Run → Run 'MyConsoleApp' 메뉴도 써봐).

잘 실행되면 아래에 Run 탭이 생길 거야. 프로그램이 실행되고, 텍스트가 출력되고, 성공적으로 끝났다는 걸 볼 수 있어. Process finished with exit code 0 — 이건 "임무 완수, 에러 없음!"이라는 뜻이야.

코드가 강의나 과제에서 봤던 거랑 좀 다르다고 느꼈을 수도 있어. 강의에서는 Top-level statements라는 걸 써서 코드를 바로 쓰는 경우가 많아. 여기선 C# 프로그램의 전형적인, 완전한 구조를 보는 거고, 실제 앱은 거의 다 이렇게 생겼어.

이 "블록" 하나하나에 대해서는 나중에 더 자세히 다룰 거야.

5. Rider 단축키

코드 분석과 실시간 에러 체크.

Rider는 코드를 실시간으로 분석해. 변수 이름을 잘못 쓰면 바로 빨간 물결로 밑줄 쳐주고, 마우스 올리면 수정 제안도 해줘.

자동완성 Windows/Linux: Ctrl+Space | macOS: ⌃Space

클래스나 메서드 이름을 Con... 이렇게 치기 시작하면, Rider가 Console 같은 후보를 보여줘. 타이핑도 빨라지고, 오타도 줄일 수 있어.

컨텍스트 액션 Windows/Linux: Alt+Enter | macOS: ⌥Enter

이건 진짜 강력한 기능이야. 코드에서 아무 단어에 커서 두고 이 조합 누르면, 상황에 맞는 액션(코드 단순화, 에러 수정, 생성자 만들기 등)을 제안해줘.

정의로 이동 Windows/Linux: Ctrl+Click 또는 F12 | macOS: ⌘Click 또는 F12

변수나 메서드 선언 위치로 바로 가고 싶으면 Ctrl(또는 Mac은 ⌘) 누르고 이름 클릭하면 돼. Rider가 바로 이동시켜줘.

안전하게 이름 바꾸기 Windows/Linux: Ctrl+R | macOS: ⌘+R

변수나 메서드 이름 바꿀 때 직접 다 고치지 말고, 커서 두고 이 조합 누르면 Rider가 프로젝트 전체에서 다 찾아서 안전하게 바꿔줘.

코드 주석 처리 Windows/Linux: Ctrl+/ | macOS: ⌘/

코드 한 줄이나 블록을 잠깐 "꺼두고" 싶으면, 선택하고 이 조합 누르면 돼. 다시 누르면 주석 해제돼.

코드 자동 정렬 Windows/Linux: Ctrl+Alt+L | macOS: ⌥⌘L

들여쓰기가 엉망이거나 코드가 보기 힘들면, 이 조합 한 번이면 파일 전체가 표준에 맞게 깔끔하게 정렬돼.

이게 개발을 엄청 편하게 해주는 기본 도구들이야. 전체 단축키 리스트는 공식 문서에서 볼 수 있어. 아니면 Rider에서 Main Menu | Help | Keyboard Shortcuts PDF 열어봐.

6. 실전 팁 & 자주 하는 실수

신입부터 시니어까지, 개발자는 매일 에러를 만나. 완전 정상이고, 중요한 건 두려워하지 말고 에러 메시지를 읽고 고칠 줄 아는 거야.

• 프로젝트가 컴파일 안 됨: .NET 버전을 잘못 골랐거나, 중요한 파일 이름을 실수로 바꿨을 수도 있어. Solution Explorer에서 구조가 맞는지 확인해봐.
• 실행 버튼이 없음: Rider가 실행할 프로젝트를 직접 골라야 할 때가 있어. 프로젝트에서 오른쪽 클릭하고 Set as Startup Project 선택해.
• bin, obj 폴더가 비어있거나 안 만들어짐: 이 폴더들은 첫 빌드(Run 또는 Build)가 성공해야 생겨.
• “.NET SDK not found” 에러: 보통 .NET이 설치 안 됐거나 Rider가 못 찾는 거야. 공식 .NET 페이지에서 SDK 다운받아서 다시 설치해봐.