개발환경 자동화 가이드 (Python venv & VS Code Auto Setup Guide)

이 문서는 Python 개발을 위한 가상환경(venv) 설정과 VS Code 자동화 방법을 안내합니다.
터미널에서 VS Code를 실행할 때마다 자동으로 venv가 활성화되도록 설정하는 것이 목표입니다.
초보자도 쉽게 따라할 수 있도록 전체 과정을 순서대로 설명합니다.

🧑‍💻 Python venv + VS Code 자동화 설정 매뉴얼

이 문서는 Python 개발 환경을 효율적으로 구성하기 위한 가상환경(venv) 설정과
VS Code 자동 실행 + 가상환경 자동 활성화를 포함한 전체 과정을 정리한 가이드입니다.
초보자도 따라할 수 있도록 상세하게 구성되어 있습니다.

✅ 1. Python 가상환경(venv) 생성

python3 -m venv ~/venv

홈 디렉토리에 venv라는 이름으로 생성됩니다.

✅ 2. 가상환경 수동 활성화

source ~/venv/bin/activate

활성화되면 (venv) 프롬프트가 나타나고, which python 시 아래처럼 출력됩니다:

/home/사용자명/venv/bin/python

✅ 3. 필수 패키지 설치

가상환경 활성화 후 다음 명령어로 필요한 패키지를 설치합니다:

pip install --upgrade pip
pip install markdown requests

✅ 4. VS Code 전용 Python 경로 설정

~/zdata/dev/.vscode/settings.json 파일을 생성하고 아래와 같이 작성합니다:

[json]
{
“python.pythonPath”: “/home/사용자명/venv/bin/python”
}
[/json]

VS Code에서 해당 디렉토리를 열었을 때 자동으로 가상환경 Python을 사용하게 됩니다.

✅ 5. .zshrc에 자동 설정 추가

vi ~/.zshrc 또는 nano ~/.zshrc 로 파일을 열어 아래 내용을 추가합니다:

</p>
<h1 id="_1">✅ 가상환경 자동 활성화</h1>
<p>if [ -d "$HOME/venv" ]; then
  source "$HOME/venv/bin/activate"
fi</p>
<h1 id="vs-code">✅ VS Code로 개발 폴더 열기</h1>
<p>alias devcode="code ~/zdata/dev"

이후 터미널을 재시작하거나 아래 명령어로 적용:

source ~/.zshrc

✅ 6. VS Code에서 자동 적용 확인

터미널에서 아래 명령어를 실행:

devcode

• ~/zdata/dev 폴더가 VS Code에서 열림
• 터미널에 (venv) 가 자동으로 활성화됨
• VS Code 우측 하단에 Python 인터프리터가 ~/venv/bin/python으로 설정되어 있음

🧪 확인 명령어

which python        # → ~/venv/bin/python
which pip           # → ~/venv/bin/pip

📝 정리

🧠 추가 팁

• VS Code에서 .vscode/settings.json 외에도 launch.json, tasks.json을 추가하면 더 정교한 개발 환경 구성 가능
• 여러 프로젝트를 운영하는 경우 프로젝트별로 개별 venv 생성 추천