Topic 4: 개발환경 구축하기 🏗️

🎯 학습 목표

파이썬 코딩을 위한 최적의 개발환경을 구축하고, 생산성을 높이는 도구들을 설정할 수 있습니다.

🤔 왜 개발환경이 중요할까요?

메모장으로도 코딩은 가능하지만, 제대로 된 개발환경은 단순한 ‘코드 작성기’가 아닙니다. 훌륭한 개발환경은 똑똑한 비서이자, 든든한 길잡이 역할을 합니다.

⚡ 개발 속도 향상: 자동 완성, 문법 검사 기능으로 타이핑 시간을 줄이고 정확도를 높입니다.
🐛 오류 감소: 코드를 작성하는 순간부터 실시간으로 잠재적인 오류를 찾아 알려줍니다.
🎨 가독성 개선: 코드의 종류에 따라 색상을 입혀(문법 강조) 한눈에 구조를 파악하기 쉽게 만듭니다.
🔧 디버깅 지원: 복잡한 문제 발생 시, 코드의 실행을 단계별로 추적하며 원인을 쉽게 찾도록 돕습니다.

영어 공부할 때 좋은 사전과 학습 도구가 필요하듯, 프로그래밍도 좋은 도구가 필수입니다!

⚔️ 두 거인의 대결: VS Code vs. PyCharm

2025년 현재, 파이썬 개발환경은 사실상 두 개의 도구가 양분하고 있습니다. 바로 Visual Studio Code와 PyCharm입니다. 우리는 이 두 가지를 모두 설치해보고, 여러분의 스타일에 맞는 것을 선택할 것입니다.

최신 개발자 설문조사 결과는 어떨까요?

Stack Overflow 2024 Survey: 전 세계 9만여 명의 개발자 대상 설문조사에서, **VS Code가 73.6%**의 압도적인 사용률로 1위를 차지했습니다. (출처 )
JetBrains State of Developer Ecosystem 2024: PyCharm 개발사에서 진행한 설문에서도 VS Code가 1위(73%), 그 뒤를 이어 JetBrains IDE(PyCharm 등)가 2위(63%)를 차지했습니다. (출처 )

이 지표들은 VS Code가 현재 가장 대중적이고 사랑받는 개발 도구임을 명확히 보여줍니다.

👨‍🏫 저의 선택과 추천은? (결론부터 말씀드리면)

첫 개발환경으로서 Visual Studio Code (VS Code)를 추천합니다.

VS Code를 추천하는 이유:

초보자에게 가장 친절합니다: 처음에는 가볍게 시작해서, 필요할 때마다 기능을 하나씩 추가하는 방식은 학습 곡선을 완만하게 만들어줍니다. 처음부터 너무 많은 기능에 압도당하지 않습니다.
범용성이 뛰어납니다: 여러분은 파이썬을 넘어 웹(HTML, CSS, JS), 데이터베이스 등 다양한 기술을 접하게 될 것입니다. VS Code 하나면 이 모든 것을 해결할 수 있습니다. ‘하나의 도구로 모든 것을’ 이라는 철학은 매우 강력합니다.
가장 인기 있는 도구입니다: 전 세계 개발자 커뮤니티에서 가장 활발하게 사용되므로, 문제 해결 정보를 얻거나 새로운 기술을 적용하기에 매우 유리합니다.

물론 PyCharm도 훌륭한 도구입니다. ‘나는 파이썬만 깊게 파겠다’ 또는 ‘모든 기능이 갖춰진 통합 환경이 좋다’고 생각하신다면 PyCharm은 최고의 선택이 될 수 있습니다.

이제, 두 가지 도구를 모두 설치하고 직접 경험해 봅시다!

Visual Studio Code로 시작하기

‘가벼운 텍스트 에디터’로 시작해, 확장 프로그램을 통해 강력한 ‘통합 개발 환경(IDE)‘으로 변신하는 조립식 로봇 같은 도구입니다.

1. VS Code 설치하기

code.visualstudio.com 접속
“Download for Windows/Mac/Linux” 클릭 후 다운로드 및 설치
(중요) 설치 옵션에서 다음 항목들을 모두 체크하세요. 파일이나 폴더를 마우스 우클릭으로 쉽게 열 수 있게 해주는 매우 편리한 기능입니다.
- ✅ Code(으)로 열기 작업을 Windows 탐색기 파일의 상황에 맞는 메뉴에 추가
- ✅ Code(으)로 열기 작업을 Windows 탐색기 디렉터리의 상황에 맞는 메뉴에 추가
- ✅ Code을(를) 지원되는 파일 형식에 대한 편집기로 등록합니다.
- ✅ PATH에 추가(다시 시작한 후 사용 가능) - 필수 체크!

2. VS Code 필수 설정 (Python 개발 환경 구축)

VS Code 설치 후, 파이썬 개발에 필요한 날개를 달아줄 차례입니다. UI를 통해 차근차근 설정해 봅시다.

① 필수 확장 프로그램 설치

Ctrl + Shift + X (또는 좌측 사이드바의 네모 블록 아이콘)를 눌러 확장 프로그램 마켓플레이스를 열고 다음을 검색하여 설치하세요.

Python (Microsoft 공식): 파이썬 언어 지원의 핵심입니다. 자동 완성, 디버깅, 코드 분석 등 모든 기능의 기반이 됩니다.
Ruff: 파이썬 코드를 검사하고 자동으로 스타일을 교정해주는, 현재 가장 빠르고 강력한 필수 도구입니다.

② Ruff란 무엇일까요? (파이썬 개발의 슈퍼툴)

발음 팁: Ruff는 ‘루프’가 아닌 ‘러프’ 라고 읽습니다. 영어 단어 ‘rough’와 발음이 같습니다.

Ruff는 2025년 현재, 파이썬 개발 생태계에서 가장 주목받는 도구입니다. 비유하자면, Python 확장 프로그램이 자동차의 ‘엔진’이라면 Ruff는 ‘최첨단 자율주행 시스템이자 자동 정비사’ 역할을 합니다.

Ruff의 핵심 기능:

린터 (Linter, 코드 검사기): 여러분이 작성하는 코드를 실시간으로 분석해서, 문법 오류, 잠재적인 버그, 사용하지 않는 변수, 스타일 가이드 위반 등을 찾아 밑줄로 표시해 줍니다. 마치 영어 작문 시 문법 검사기가 오탈자나 어색한 문장을 찾아주는 것과 같습니다.
포맷터 (Formatter, 코드 정리기): 정해진 규칙(주로 PEP 8 스타일 가이드)에 따라 코드의 들여쓰기, 줄 간격, 따옴표 종류 등을 자동으로 통일시켜 줍니다. 덕분에 여러 사람이 함께 작업해도 항상 일관된 스타일의 코드를 유지할 수 있습니다.

Ruff를 써야 하는 이유:

⚡️ 압도적인 속도: Rust 언어로 만들어져, 기존의 다른 도구들(Pylint, Flake8, Black 등)보다 수십, 수백 배 빠릅니다. 저장하는 순간 즉시 모든 검사와 정리가 끝납니다.
🛠️ 올인원 (All-in-One): 린터 + 포맷터 + 임포트 정리 등 여러 도구를 따로 설치하고 설정할 필요 없이, Ruff 하나로 모든 것을 해결할 수 있습니다.

③ VS Code 설정하기 (UI 기반)

파이썬 인터프리터 선택하기
- Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다.
- Python: Select Interpreter를 검색하고 선택합니다.
- 목록에서 여러분이 설치한 파이썬 버전(예: Python 3.13.5)을 클릭합니다.
기본 포맷터를 Ruff로 지정하기
- 아무 파이썬 파일(hello.py 등)을 하나 엽니다.
- Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다.
- Format Document With...를 검색하고 선택합니다.
- 나타나는 목록에서 Ruff를 선택합니다.
저장 시 자동 포맷팅 활성화하기
- Ctrl + ,를 눌러 설정(Settings) 창을 엽니다.
- 검색창에 Format On Save를 입력합니다.
- Editor: Format On Save 항목에 나타난 체크박스를 클릭하여 활성화합니다.

④ 설정 확인하기 (`settings.json`)

위에서 UI를 통해 변경한 설정들은 사실 settings.json이라는 설정 파일에 저장됩니다. 모든 설정이 잘 되었는지 최종적으로 확인해 봅시다.

Ctrl + ,로 설정 창을 열고, 우상단의 파일 아이콘(Open Settings (JSON))을 클릭하세요.
settings.json 파일이 열리면, 아래와 같은 내용이 포함되어 있는지 확인하세요. (다른 설정들이 더 있을 수 있습니다.)


{
  // 파이썬 파일에만 적용되는 설정들
  "[python]": {
    // 기본 포맷터를 'Ruff'로 지정
    "editor.defaultFormatter": "charliermarsh.ruff",
    // 저장 시 자동 포맷팅 활성화
    "editor.formatOnSave": true,
    // 저장 시 추가 동작: 모든 오류 자동 수정 및 import 정리
    "editor.codeActionsOnSave": {
      "source.fixAll": "explicit",
      "source.organizeImports": "explicit"
    }
  },
  // Pylance 타입 검사 기능 활성화
  "python.analysis.typeCheckingMode": "basic"
}

팁: editor.codeActionsOnSave 설정은 UI로 설정하기 번거롭습니다. 만약 이 부분이 없다면, 위 코드를 복사하여 여러분의 settings.json 파일에 붙여넣어 주세요. 저장 시 코드를 자동으로 수정하고 정리해주는 매우 강력한 기능입니다.

3. 코드 실행 및 테스트

Ctrl + N을 눌러 새 파일을 만들고, 아래 코드를 붙여넣은 후 hello.py로 저장하세요.
Ctrl + S로 저장하는 순간, Ruff가 작동하여 코드가 자동으로 깔끔하게 정리되는 것을 확인하세요!
실행 방법:
- 실행 버튼: 에디터 우상단의 ▶️ 버튼 클릭 (가장 쉬움)
- 터미널: Ctrl + \`` (백틱)으로 터미널을 열고 python hello.py` 입력
- 선택 실행: 실행하고 싶은 코드를 드래그하여 선택하고 Shift + Enter


def greet( name ):
    """사용자에게 인사하는 멋진 함수"""
    print(f"Hello, {name}!")
    print( "Welcome to VS Code!" )
 
greet( "Pythonista" )

PyCharm으로 시작하기

파이썬 개발을 위한 모든 것이 갖춰진 ‘올인원’ 풀옵션 자동차와 같습니다. 처음부터 강력한 기능을 제공하여 사용자를 지원합니다.

1. PyCharm 설치하기

PyCharm은 **Community(무료)**와 Professional(유료) 두 가지 버전이 있습니다. 우리는 모든 기능이 충분한 무료 버전 Community를 설치할 것입니다.

www.jetbrains.com/pycharm/download/ 접속
Community 버전 다운로드 후 설치
설치 옵션에서 다음 항목들을 체크하세요:
- Create Desktop Shortcut (바탕화면 바로가기)
- Add "Open Folder as Project" (폴더를 프로젝트로 열기)
- Create Associations (.py 파일 연결)
- Add launchers dir to the PATH (명령줄에서 실행)

2. 프로젝트와 가상 환경(Virtual Environment)

PyCharm의 가장 큰 특징은 ‘프로젝트’ 단위로 모든 것을 관리한다는 점입니다. VS Code가 폴더를 여는 개념이라면, PyCharm은 프로젝트를 생성하는 개념에 가깝습니다.

가상 환경(Virtual Environment)이란?

프로젝트마다 독립된 ‘파이썬 작업 공간’을 만들어주는 기능입니다.

상황: 프로젝트 A는 라이브러리 X 버전 1.0이 필요하고, 프로젝트 B는 버전 2.0이 필요할 때 충돌이 발생할 수 있습니다.
해결: 가상 환경은 프로젝트별로 필요한 라이브러리를 격리된 공간에 설치하여, 서로 영향을 주지 않도록 합니다. venv가 가장 기본적인 가상 환경 도구입니다.

3. 새 프로젝트 생성 및 환경 설정

PyCharm 실행 후 New Project 클릭
Location: 프로젝트를 저장할 폴더 경로를 지정합니다. (예: C:\Users\YourName\PycharmProjects\pythonProject1)
Python Interpreter: New environment using > Virtualenv 선택 (기본값)
- PyCharm이 이 프로젝트만을 위한 파이썬 가상 환경을 자동으로 생성해 줍니다.
Create 버튼 클릭

4. 코드 실행 및 테스트

프로젝트가 생성되면 왼쪽 탐색기에서 프로젝트 폴더를 우클릭 > New > Python File 선택
파일 이름을 main으로 입력하고 엔터
아래 코드를 붙여넣고, 에디터 우상단의 ▶️ 버튼을 누르거나 Shift + F10 단축키로 실행


def main():
    """파이참 메인 함수"""
    name = "PyCharm User"
    print(f"Hello, {name}!")
    print("Welcome to PyCharm!")
 
if __name__ == "__main__":
    main()

🎨 공통: 개발 환경 꾸미기 (선택사항)

어떤 도구를 선택하든, 여러분의 눈을 편안하게 하고 코딩을 즐겁게 만들어 줄 테마와 폰트를 설정해 보세요.

✅ 개발환경 점검 체크리스트

VS Code 또는 PyCharm (혹은 둘 다) 설치를 완료했다.(VS Code) Python, Ruff 확장 프로그램을 설치했다.(VS Code) 파이썬 인터프리터를 설정하고, settings.json을 구성했다.(PyCharm) 새 프로젝트를 생성하고, 가상 환경의 개념을 이해했다.각 도구에서 간단한 hello world 파이썬 코드를 작성하고 실행하는 데 성공했다.자동 완성, 문법 강조, 자동 포맷팅(저장 시) 기능이 잘 작동한다.

🎉 Unit 1 완주!

개발환경 구축까지 완료하면서 파이썬 학습을 위한 모든 준비를 마쳤습니다!

🏆 Unit 1에서 배운 내용

프로그래밍이라는 새로운 언어: 컴퓨터와 소통하는 방법 이해
왜 파이썬일까?: 파이썬을 선택하는 이유와 장점
파이썬 설치하기: 운영체제별 파이썬 설치와 설정
개발환경 구축하기: VS Code 또는 PyCharm으로 최적의 코딩 환경 완성

🚀 이제 준비된 것들

파이썬 프로그래밍에 대한 기본 이해
파이썬이 왜 좋은 언어인지에 대한 확신
완벽하게 설치된 파이썬 환경
효율적인 코딩을 위한 전문 개발도구
첫 번째 파이썬 코드 실행 경험

축하합니다! 이제 파이썬 프로그래밍을 시작할 모든 준비가 완료되었습니다! 🎊

다음 Unit에서는 실제 파이썬 코딩을 시작합니다. Hello World부터 변수, 연산자까지 파이썬의 기본 요소들을 하나씩 정복해나가겠습니다!

Topic 4: 개발환경 구축하기 🏗️

🎯 학습 목표

🤔 왜 개발환경이 중요할까요?

⚔️ 두 거인의 대결: VS Code vs. PyCharm

👨‍🏫 저의 선택과 추천은? (결론부터 말씀드리면)

Visual Studio Code로 시작하기

1. VS Code 설치하기

2. VS Code 필수 설정 (Python 개발 환경 구축)

① 필수 확장 프로그램 설치

② Ruff란 무엇일까요? (파이썬 개발의 슈퍼툴)

③ VS Code 설정하기 (UI 기반)

④ 설정 확인하기 (`settings.json`)

3. 코드 실행 및 테스트

PyCharm으로 시작하기

1. PyCharm 설치하기

2. 프로젝트와 가상 환경(Virtual Environment)

3. 새 프로젝트 생성 및 환경 설정

4. 코드 실행 및 테스트

🎨 공통: 개발 환경 꾸미기 (선택사항)

추천 테마

추천 코딩 폰트

✅ 개발환경 점검 체크리스트

✅ 개발환경 점검 체크리스트

🎉 Unit 1 완주!

🏆 Unit 1에서 배운 내용

🚀 이제 준비된 것들

Topic 4: 개발환경 구축하기 🏗️

🎯 학습 목표

🤔 왜 개발환경이 중요할까요?

⚔️ 두 거인의 대결: VS Code vs. PyCharm

👨‍🏫 저의 선택과 추천은? (결론부터 말씀드리면)

Visual Studio Code로 시작하기

1. VS Code 설치하기

2. VS Code 필수 설정 (Python 개발 환경 구축)

① 필수 확장 프로그램 설치

② Ruff란 무엇일까요? (파이썬 개발의 슈퍼툴)

③ VS Code 설정하기 (UI 기반)

④ 설정 확인하기 (settings.json)

3. 코드 실행 및 테스트

PyCharm으로 시작하기

1. PyCharm 설치하기

2. 프로젝트와 가상 환경(Virtual Environment)

3. 새 프로젝트 생성 및 환경 설정

4. 코드 실행 및 테스트

🎨 공통: 개발 환경 꾸미기 (선택사항)

추천 테마

추천 코딩 폰트

✅ 개발환경 점검 체크리스트

✅ 개발환경 점검 체크리스트

🎉 Unit 1 완주!

🏆 Unit 1에서 배운 내용

🚀 이제 준비된 것들

④ 설정 확인하기 (`settings.json`)