파이썬 공부를 시작할 때 가장 먼저 막히는 구간은 문법이 아니라 개발 환경입니다. 설치는 했는데 실행이 안 되거나, VS Code에서 다른 파이썬을 잡는 경우가 많기 때문입니다. 이 글에서는 초보자 기준으로 파이썬 개발 환경을 가장 단순하게 준비하는 순서를 정리합니다.
Table of Contents
개발 환경에서 필요한 것
처음에는 아래 3가지만 준비하면 충분합니다.
- 파이썬 설치
- 코드 편집기 설치
- 실행과 버전 확인
처음부터 복잡한 도구를 많이 깔기보다, 실행이 되는 최소 환경부터 만드는 편이 좋습니다.
1. 파이썬 설치하기
가장 먼저 파이썬을 설치합니다. 운영체제에 따라 설치 방식은 다르지만, 핵심은 설치 후 실제로 명령어가 동작하는지 확인하는 것입니다.
python --version
python3 --versionWindows에서는 python 또는 py, macOS와 Linux에서는 python3가 먼저 동작하는 경우가 많습니다.
버전 확인이 안 된다면 아래 글부터 같이 보면 됩니다.
2. VS Code 설치하기
입문자는 VS Code부터 시작하는 것이 가장 무난합니다. 가볍고 자료가 많고, 파이썬 확장도 잘 갖춰져 있기 때문입니다.
VS Code를 설치한 뒤에는 Python 확장을 추가합니다. 그러면 코드 실행, 인터프리터 선택, 기본적인 디버깅까지 한 곳에서 할 수 있습니다.
3. 작업 폴더 만들기
연습 파일을 아무 데나 만들면 나중에 헷갈리기 쉽습니다. 예를 들어 PythonWorkspace 같은 폴더를 하나 만들고, 그 안에서 파일을 관리하면 정리가 편합니다.
4. 첫 파이썬 파일 만들기
새 파일을 만들고 확장자를 .py로 저장합니다. 예를 들면 hello.py처럼 시작하면 됩니다.
print("hello world")이 한 줄이 실행되면 개발 환경의 기본 세팅은 된 것입니다.
5. VS Code에서 인터프리터 확인하기
설치는 됐는데 실행이 안 되거나 패키지가 꼬이는 이유는, VS Code가 다른 파이썬을 보고 있기 때문인 경우가 많습니다. 이때는 Python: Select Interpreter로 현재 인터프리터를 확인합니다.
자세한 방법은 아래 글로 연결해 두겠습니다.
6. pip도 같이 확인하기
환경을 만들었다면 패키지 설치 도구인 pip가 어느 파이썬과 연결돼 있는지도 같이 보는 것이 좋습니다.
python -m pip --version
python3 -m pip --version이 과정을 해두면 나중에 pip install은 됐는데 import가 안 되는 문제를 줄일 수 있습니다.
관련 글:
초보자가 많이 막히는 지점
1. 설치는 했는데 명령어가 안 되는 경우
대부분 PATH 문제이거나 Windows 실행 별칭 문제입니다.
2. VS Code에서는 되는데 터미널에서는 안 되는 경우
서로 다른 인터프리터를 보고 있을 가능성이 큽니다.
3. pip로 설치했는데 import가 안 되는 경우
현재 실행 중인 파이썬과 pip가 다른 환경을 가리키는 경우가 많습니다.
추천 시작 순서
- 파이썬 설치
- 버전 확인
- VS Code 설치
- Python 확장 설치
hello.py실행- 인터프리터 확인
- pip 위치 확인
정리
파이썬 개발 환경 구축은 복잡한 도구를 많이 깔아서 해결하는 문제가 아니라, 설치, 버전 확인, 실행, 인터프리터 확인을 순서대로 점검하면 되는 문제입니다. 이 기본 흐름만 잡히면 이후 문법 공부나 프로젝트 실습으로 훨씬 자연스럽게 넘어갈 수 있습니다.
다음 글에서는 자료형과 변수처럼 실제 문법으로 바로 이어가면 됩니다.
