안녕하세요! 요즘 직장인들 사이에서 '바이브 코딩(Vibe Coding)'이라는 말이 유행하고 있습니다. 거창한 개발자가 아니더라도, 업무 중에 필요한 간단한 툴이나 자동화 기능을 파이썬(Python)으로 직접 만들어 사용하는 분들이 늘어나고 있죠. 저 역시 회사 업무 효율을 높이기 위해 파이썬을 적극적으로 활용하고 있습니다.
지난 포스팅에서 파이썬 기초 설치법을 다루었다면, 오늘은 실제 코딩을 할 때 가장 많이 사용하는 IDE(통합 개발 환경)인 VSCode(Visual Studio Code)에 파이썬 개발 환경을 구축하고, 프로젝트별로 독립적인 실행 환경을 만들어주는 가상환경(venv) 설정 방법까지 상세히 알아보겠습니다.
1. VSCode 실행 및 파이썬 확장 프로그램 설치
먼저 설치된 VSCode를 실행합니다. VSCode는 그 자체로도 훌륭한 텍스트 에디터이지만, 파이썬 코딩을 제대로 하기 위해서는 마이크로소프트에서 제공하는 공식 확장 프로그램을 설치해야 합니다.
- VSCode 왼쪽 사이드바에서 네 개의 네모 상자가 쌓여 있는 모양의 아이콘(Extensions)을 클릭합니다. (단축키:
Ctrl + Shift + X) - 상단 검색창에 'Python'을 입력합니다.
- 목록 가장 상단에 있는 Microsoft에서 제작한 Python 확장 프로그램을 선택합니다.
- [Install] 버튼을 눌러 설치를 진행합니다. (이미 설치되어 있다면 'Disable'이나 'Uninstall'로 표시됩니다.)
Tip: 이 확장 프로그램을 설치하면 코드 자동 완성(IntelliSense), 디버깅, 유닛 테스트 지원 등 파이썬 개발에 필수적인 기능들을 바로 사용할 수 있게 됩니다.
2. 파이썬 프로젝트 전용 작업 폴더 생성하기
코딩을 시작하기 전, 소스 코드를 체계적으로 관리할 수 있는 작업 폴더를 만드는 것이 중요합니다. 폴더 경로는 가급적 한글이 포함되지 않은 영문 경로를 추천합니다.
- 파일 탐색기를 열고 원하는 위치에 새 폴더를 생성합니다.
- 예시에서는 C드라이브 바로 아래에
PythonWorkSpace라는 이름의 폴더를 만들었습니다. - 경로에 한글이나 공백이 있으면 가끔 라이브러리 설치 시 오류가 발생할 수 있으므로, 되도록 위 예시처럼 깔끔하게 이름을 지어주는 것이 좋습니다.
3. VSCode에서 작업 폴더 열기
이제 방금 만든 폴더를 VSCode로 불러와 본격적인 프로젝트 환경을 구성해 보겠습니다.
- VSCode 상단 메뉴에서 [File] -> [Open Folder]를 선택합니다.
- 방금 생성한
PythonWorkSpace폴더를 찾아 선택한 후 [Select Folder] 버튼을 누릅니다.
이제 왼쪽 탐색기(Explorer) 창에 해당 폴더 이름이 나타나며, 이 안에서 생성하는 모든 파일은 해당 폴더에 저장됩니다.
4. 터미널 열기 및 독립적 가상환경(venv) 구축
파이썬 개발에서 가장 중요한 단계 중 하나가 바로 가상환경(Virtual Environment) 설정입니다. 프로젝트마다 필요한 라이브러리 버전이 다를 수 있는데, 가상환경을 사용하면 서로 간섭 없이 독립적인 환경을 유지할 수 있습니다.
- VSCode 상단 메뉴에서 [Terminal] -> [New Terminal]을 클릭합니다.
- 화면 하단에 터미널 창이 열리면 아래의 명령어를 순서대로 입력합니다.
Step 1: 가상환경 생성하기
터미널에 다음 명령어를 입력하고 Enter를 누릅니다.
python -m venv venv
잠시 기다리면 왼쪽 탐색기 창에 venv라는 이름의 폴더가 새로 생긴 것을 확인할 수 있습니다. 이것이 바로 이 프로젝트 전용의 독립된 파이썬 환경입니다.
Step 2: 가상환경 활성화하기
가상환경을 만들었다면, 이제 시스템에 설치된 기본 파이썬이 아닌 이 가상환경을 사용하겠다고 '활성화'를 해주어야 합니다. 윈도우 기준으로 터미널에 다음 명령어를 입력합니다.
venv\Scripts\activate성공적으로 활성화되었다면, 터미널 입력창 맨 앞에 (venv)라는 초록색 글자가 표시됩니다. 이 표시가 있어야 현재 가상환경 안에서 작업 중이라는 뜻입니다.
5. 왜 가상환경(venv)을 써야 할까요?
초보자분들이 가장 많이 하는 실수 중 하나가 모든 라이브러리를 컴퓨터 전체 환경(Global)에 설치하는 것입니다. 가상환경을 쓰면 다음과 같은 장점이 있습니다.
- 버전 충돌 방지: 프로젝트마다 필요한 라이브러리 버전을 다르게 유지할 수 있습니다.
- 깔끔한 관리: 프로젝트 삭제 시 가상환경 폴더만 지우면 시스템이 깨끗하게 유지됩니다.
- 협업 용이성: 내가 어떤 환경에서 개발했는지 타인에게 정확히 전달할 수 있습니다.
마치며
이제 VSCode에서 파이썬 코드를 작성하고 실행할 모든 준비가 끝났습니다! 독립적인 환경까지 구축했으니, 이제 라이브러리 충돌 걱정 없이 마음껏 코딩 바이브를 즐기시면 됩니다. 궁금한 점이 있다면 댓글로 남겨주세요!