개발정보

파이참(PyCharm) 초기 설정 완전 정복 2026 — 설치 후 꼭 해야 할 것들

Iam_noob 2026. 5. 15. 14:09
728x90
반응형

 

2026.1 최신판

파이참(PyCharm) 초기 설정
완전 정복 2026

PyCharm 설치 후 그냥 쓰면 느리고 불편해요. Python 인터프리터 오류, 가상환경 설정, 폰트, 자동 포맷까지 — 설치 직후 반드시 해야 할 것들을 순서대로 정리했습니다.

2026.05.13 · be-a-developer.tistory.com

출처: https://www.jetbrains.com/ko-kr/pycharm/download/?section=windows

PyCharm을 처음 설치하면 당황스러운 일들이 생겨요. Python 인터프리터를 못 찾는다고 하거나, 분명히 pip install 했는데 모듈을 인식 못 하거나, 코드 실행이 안 되거나. 전부 초기 설정을 제대로 안 잡아서 생기는 문제예요.

저도 처음 PyCharm 썼을 때 가상환경 때문에 한 시간을 날렸어요. 알고 보면 인터프리터 설정 하나였는데. 이 글은 그런 삽질을 안 하도록 설치 직후 반드시 해야 하는 설정들만 순서대로 정리했습니다.

2026년 기준으로 PyCharm은 단일 통합 버전으로 바뀌었어요. Community/Professional 구분이 없어졌고 핵심 기능은 무료예요. 설정 화면은 Cmd + , (맥) / Ctrl + Alt + S (윈도우)로 열어요.

01 PyCharm 설치 방법 (맥/윈도우)

2026년부터 PyCharm은 하나의 통합 버전으로만 배포돼요. jetbrains.com/pycharm에서 다운로드하거나 아래 명령어로 설치하세요.

🍎 macOS — Homebrew 추천

brew install --cask pycharm

또는 JetBrains Toolbox App 통해 설치

🪟 Windows

winget install JetBrains.PyCharm

또는 공식 사이트에서 .exe 다운로드

📌 2026년 PyCharm 요금제 요약

무료 (기본) Python 개발, Jupyter, 디버거, Git, AI 기본 기능
Pro ($99/년, 첫해) Django/Flask, DB 도구, 원격 인터프리터

💡 추천: 무료 플랜으로 시작하고 Django/Flask 웹 개발이 필요하면 Pro 전환하세요. 30일 무료 체험도 가능해요.


02 ★가장 중요 Python 인터프리터 설정

PyCharm이 Python을 못 찾으면 아무것도 안 돼요. 코드 실행도, 자동완성도, pip install도 전부 Python 인터프리터가 연결돼야 동작해요. 설치 직후 제일 먼저 확인해야 합니다.

Python 먼저 설치해야 해요

# macOS — Homebrew로 Python 설치
brew install python@3.12

# 설치 확인
python3 --version

# Windows — 공식 사이트에서 .exe 다운로드
# python.org → Downloads → Python 3.12.x
# ⚠️ 설치 시 "Add Python to PATH" 반드시 체크!

PyCharm에서 인터프리터 연동

Settings → Project → Python Interpreter

1. Python Interpreter 옆 톱니바퀴 아이콘 → Add Interpreter 클릭
2. System Interpreter 선택 → Python 3.12 경로 지정
3. 우측 하단에 Python 버전 표시되면 연동 성공

⚠️ 자주 겪는 오류 — "No Python interpreter configured"

Python을 설치했는데 PyCharm이 못 찾는 경우예요. 해결 방법은 간단해요.

# 터미널에서 Python 경로 확인
which python3  # macOS
where python   # Windows

# 나온 경로를 PyCharm Interpreter에 직접 입력

03 ★필수 개념 가상환경(venv) 설정

Python 개발에서 가상환경은 선택이 아니에요. "pip install했는데 모듈을 못 찾는다"는 문제의 99%가 가상환경 설정 때문이에요.

가상환경이 필요한 이유

프로젝트 A는 Django 4.0, 프로젝트 B는 Django 5.0이 필요할 수 있어요. 가상환경 없이 전역에 설치하면 충돌이 생겨요. 프로젝트마다 독립된 Python 환경을 만드는 게 가상환경이에요.

PyCharm에서 가상환경 만들기

새 프로젝트 생성 시 (가장 쉬운 방법)

1. File → New Project
2. Python Interpreter: New environment using → Virtualenv 선택
3. Create 클릭 → 프로젝트 폴더에 .venv 폴더 자동 생성
# 터미널에서 직접 만드는 방법 (2026년 uv 방식 추천)
pip install uv
uv venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate     # Windows

# uv는 pip보다 10~100배 빠른 패키지 관리자예요
uv pip install django

💡 2026년 팁: PyCharm 2026.1부터 uv가 기본 환경 관리자로 채택됐어요. pip보다 훨씬 빠르니까 uv 써보는 걸 추천해요.


04 메모리 설정 — 느리다면 이것부터

PyCharm이 느린 이유 1위는 메모리 설정이에요. 기본값이 너무 낮아서 조금만 써도 버벅거려요. Help → Edit Custom VM Options로 수정해요.

# Help → Edit Custom VM Options 클릭 후 수정

# 기본값 (너무 낮음)
-Xms128m
-Xmx750m

# RAM 16GB 기준 추천값
-Xms512m
-Xmx2048m
RAM 용량 -Xms -Xmx
8GB 256m 1024m
16GB 512m 2048m
32GB+ 1024m 4096m

💡 실제 경험: 기본값 750m에서 2048m으로 올렸더니 인덱싱 속도가 눈에 띄게 빨라졌어요. PyCharm 느리면 이것부터 확인하세요.


05 폰트 및 에디터 설정

🇰🇷 한국 개발자라면 D2Coding 강력 추천

네이버에서 만든 코딩 전용 폰트예요. 한글 주석이 많은 국내 프로젝트에서 가독성이 압도적으로 좋아요. Python 코드에 한글 주석 많이 쓰신다면 D2Coding이 최적이에요.

# macOS — Homebrew로 설치
brew install --cask font-d2coding

# Windows — GitHub에서 다운로드
https://github.com/naver/d2codingfont

Settings → Editor → Font

Font D2Coding (또는 JetBrains Mono)
Size 14 ~ 16 (기본 12는 너무 작음)
Line spacing 1.2 (가독성 향상)

에디터 편의 설정

Settings → Editor → General

Show line numbers 켜기 (필수)
Change font size with Ctrl+Wheel 켜기
Show indent guides 켜기 (Python 들여쓰기 확인)
Use soft wraps in editor 취향껏

06 자동 저장 및 자동 포맷 설정

Python은 PEP 8 코딩 스타일 가이드가 있어요. 저장할 때 자동으로 PEP 8에 맞게 포맷되게 설정하면 코드 스타일이 자동으로 통일돼요.

Settings → Tools → Actions on Save

Reformat code 켜기 ← 핵심
Optimize imports 켜기 (미사용 import 자동 제거)
Run code cleanup 선택 (무거울 수 있음)

Python 코드 스타일 설정

Settings → Editor → Code Style → Python

Tab size 4 (PEP 8 표준)
Use tab character 끄기 (스페이스 4칸이 표준)

💡 팁: 2026년 PyCharm에서 Ruff 린터가 내장 지원돼요. Settings → Python → Tools에서 Ruff 활성화하면 저장 시 자동 포맷+린팅이 동시에 돼요.


07 필수 단축키 모음

기능 Mac Windows
전체 검색 (가장 중요) Shift + Shift Shift + Shift
코드 실행 Ctrl + Shift + R Shift + F10
디버그 실행 Ctrl + Shift + D Shift + F9
자동완성 Ctrl + Space Ctrl + Space
빠른 수정 Opt + Enter Alt + Enter
선언부로 이동 Cmd + B Ctrl + B
이름 변경 Shift + F6 Shift + F6
코드 포맷 Cmd + Opt + L Ctrl + Alt + L
주석 토글 Cmd + / Ctrl + /

08 Git 연동 설정

Settings → Version Control → Git

Git 경로 확인 Test 버튼으로 정상 여부 확인
Update method Rebase 추천
# Git 기본 설정 (터미널에서 한 번만)
git config --global user.name "이름"
git config --global user.email "이메일@example.com"
git config --global init.defaultBranch main

💡 팁: PyCharm 좌측 하단 Git 탭에서 브랜치, 커밋 히스토리, 변경 파일을 한눈에 볼 수 있어요. 터미널 git log보다 훨씬 보기 편해요.


09 2026 신규 AI 기능 설정

2026년 PyCharm은 AI 기능이 대폭 강화됐어요. Claude Agent, Junie AI가 기본 내장됐고, 본인 API 키를 연결해서 Claude나 GPT를 직접 쓸 수도 있어요.

AI Chat (기본 내장)

우측 패널 AI 아이콘 클릭 → 코드 질문, 리뷰, 설명 요청 가능. 무료 플랜에서도 기본 제공돼요.

BYOK — 내 API 키 연결 (2026 신규)

Settings → AI Assistant → Bring Your Own Key에서 OpenAI, Anthropic(Claude), 로컬 모델 API 키를 직접 연결할 수 있어요.

Settings → AI Assistant → Model → Add Custom API Key

Next Edit Suggestions (NES)

코드 수정하면 다음에 바꿔야 할 곳을 AI가 미리 예측해서 인라인으로 제안해줘요. 함수 파라미터 추가하면 관련 코드를 연쇄적으로 수정 제안해요.


10 설정 완료 체크리스트

전부 완료하면 PyCharm 세팅 끝

PyCharm 최신 버전 설치 (2026.1)
Python 설치 + 인터프리터 연동 ← 필수
프로젝트 가상환경(venv) 설정 ← 필수
메모리 설정 (Xmx 증가)
D2Coding 폰트 설치 및 적용 (사이즈 14+)
줄 번호 표시 + 들여쓰기 가이드 켜기
저장 시 Reformat + Optimize imports 켜기
Git 사용자 정보 설정
AI 기능 설정 (API 키 연결 또는 기본 내장 사용)

마무리

PyCharm 초기 설정에서 제일 중요한 건 딱 두 가지예요. Python 인터프리터 연동가상환경 설정. 이 두 개만 잡아도 "왜 안 되지?" 하는 오류의 대부분이 사라져요.

세팅하다 막히는 부분 있으면 댓글 달아주세요!

📌 함께 읽으면 좋은 글

→ 파이참(PyCharm) 플러그인 추천 2026 — Python 개발자 필수 모음

 

→ IntelliJ IDEA 초기 설정 완전 정복 2026

→ VSCode 초기 설정 완전 정복 2026

→ IntelliJ vs Eclipse vs VSCode — 2026년 뭘 써야 할까?

728x90
반응형