macOS에서 VSCode로 Python 프로젝트 시작하기

macOS에서 VSCode로 Python 프로젝트 시작하기

Python 프로젝트를 시작할 때 가상환경을 사용하는 것은 패키지 관리와 프로젝트 독립성을 유지하는 데 큰 도움이 된다. 이번 포스트에서는 macOS에서 VSCode 터미널을 이용해 Python 가상환경을 생성하고 프로젝트를 시작하는 과정을 단계별로 설명한다.

---

1. 프로젝트 폴더 열기

프로젝트를 위한 폴더를 생성하고 VSCode에서 해당 폴더를 연다. 터미널에서 아래 명령어를 입력해 폴더를 생성하고 이동한다:

mkdir my_project
cd my_project

이렇게 생성한 폴더를 VSCode로 연다.

---

2. VSCode에서 통합 터미널 열기

VSCode 상단 메뉴에서 Terminal > New Terminal을 선택하거나 단축키 Cmd+`를 눌러 통합 터미널을 연다.

---

3. Python 가상환경 생성하기

Python 3 이상이 설치되어 있다면, 아래 명령어를 통해 가상환경을 생성한다. 여기서는 가상환경 폴더 이름을 .env로 사용한다.

python3 -m venv .env

이 명령어를 실행하면 .env 폴더에 Python 가상환경이 생성된다.

---

4. 가상환경 활성화하기

가상환경을 활성화하려면 아래 명령어를 입력한다:

source .env/bin/activate

터미널 프롬프트 앞에 (.env)가 표시되면 가상환경이 활성화된 상태임을 확인할 수 있다.

---

5. VSCode에서 Python 인터프리터 설정하기

가상환경을 활성화한 후, VSCode에서 Python 인터프리터를 해당 가상환경으로 설정한다.

1. Command Palette 열기: Cmd+Shift+P를 누른다.
2. “Python: Select Interpreter”를 검색해 선택한다.
3. 생성한 가상환경인 .env/bin/python을 선택한다.

이제 VSCode가 해당 가상환경을 사용하도록 설정된다.

---

6. 프로젝트 파일 생성 및 실행

프로젝트 파일을 생성한다. 예를 들어, main.py 파일을 생성하고 아래와 같이 코드를 작성한다:

# main.py
print("Hello, World!")

터미널에서 아래 명령어로 파일을 실행한다:

python main.py

코드가 실행되면 “Hello, World!”가 출력된다.

---

7. 필요 패키지 설치 및 관리

프로젝트에 필요한 패키지를 설치할 때도 가상환경 내에서 진행한다. 예를 들어, requests 패키지를 설치하려면 아래 명령어를 입력한다:

pip install requests

설치된 패키지 목록을 requirements.txt 파일로 저장하려면 아래 명령어를 입력한다:

pip freeze > requirements.txt

이 파일은 나중에 다른 환경에서 동일한 패키지를 설치할 때 유용하게 사용된다.

---

마무리

이와 같이 진행하면 macOS에서 VSCode 터미널을 이용해 Python 가상환경을 생성하고 프로젝트를 시작할 수 있다. 각 단계별로 따라 하면서 Python 개발 환경을 설정한다면, 보다 효율적인 프로젝트 관리를 할 수 있다.