30초 요약
- 가상환경은 활성화하지 않아도 쓴다.
venv/bin/python script.py처럼 인터프리터 경로를 직접 주면 된다. - 가상환경에 설치된 명령(
pip, 패키지의 콘솔 스크립트)도venv/bin/이름으로 바로 실행된다. - 스크립트 첫 줄을
#!/절대경로/venv/bin/python으로 쓰면PATH와 상관없이 그 환경으로 돈다.
증상/목표
cron이나 배포 스크립트에서 파이썬 스크립트를 부를 때마다 source venv/bin/activate를 앞에 붙이는 일이 번거롭다. 활성화는 대화형 셸을 위한 편의 기능이라 이런 자리에서는 빼도 된다. 목표는 활성화 없이도 항상 가상환경의 패키지로 스크립트가 도는 상태다.
원인
활성화 스크립트가 하는 일은 가상환경의 bin 디렉터리를 PATH 앞에 붙이는 것이다. 그래서 python을 치면 가상환경의 인터프리터가 먼저 잡힌다. 공식 문서도 활성화가 꼭 필요하지는 않고, 환경의 파이썬 경로를 직접 지정해 호출해도 되며 설치된 스크립트는 활성화 없이 실행되어야 한다고 적는다.
활성화하지 않은 셸에서는 python3가 시스템 파이썬을 가리키므로 가상환경에만 설치한 패키지를 찾지 못한다. 경로로 부르면 이 문제가 생기지 않는다.
활성화는 편의 기능이라 cron 같은 자리에서는 경로로 부른다
- activate 후 실행: source venv/bin/activate를 먼저 실행한다 · bin 디렉터리가 PATH 앞에 붙는다 · python을 이름만으로 부를 수 있다 · VIRTUAL_ENV가 가상환경 경로로 설정된다
- 경로로 직접 호출: 활성화 없이 venv/bin/python job.py로 실행한다 · 설치된 명령은 venv/bin/이름으로 실행한다 · shebang은 PATH와 상관없이 돈다 · cron에서는 절대 경로를 쓴다
해결 방법
1. 가상환경을 만들고 패키지를 설치한다
python3 -m venv venvvenv/bin/python -m pip install cowsaypip 앞에 venv/bin/python -m을 붙이면 어느 환경의 pip인지 헷갈릴 일이 없다.
2. 인터프리터 경로로 스크립트를 실행한다
venv/bin/python job.pycron 같은 자리에서는 절대 경로를 쓴다.
*/10 * * * * /home/me/app/venv/bin/python /home/me/app/job.py3. 설치된 명령도 경로로 실행한다
패키지가 설치하는 콘솔 스크립트는 venv/bin/ 아래에 생긴다.
venv/bin/cowsay -t hello이 스크립트의 첫 줄(shebang)에는 가상환경의 파이썬 절대 경로가 적혀 있다. 그래서 PATH가 어떻든 그 인터프리터로 실행된다.
4. 내 스크립트도 shebang으로 고정한다
첫 줄에 가상환경의 파이썬을 적고 실행 권한을 준다.
#!/home/me/app/venv/bin/pythonimport cowsaychmod +x job.py./job.py5. 셸 스크립트에서는 변수로 한 번만 적는다
PY=/home/me/app/venv/bin/python"$PY" -m pip list"$PY" /home/me/app/job.py확인
활성화하지 않은 셸에서 시스템 python3는 패키지를 찾지 못하고, 경로로 부른 venv의 python은 찾는다. shebang 스크립트는 PATH를 비운 환경(env -i)에서도 돈다. 아래 실행 결과에서 각 단계를 확인한다.
검증 범위: 리눅스 러너에서 python3 -m venv로 만든 환경을 대상으로 실행했다. 윈도우의 Scripts 폴더와 .exe 실행기, 환경을 다른 위치로 옮겼을 때의 동작은 실행하지 않았다.
검증 환경 3항목
| OS | Ubuntu 24.04.5 |
|---|---|
| Python | 3.12.3 |
| 실행 날짜 | 2026-10-27 |
[PASS] venv 폴더에 bin/python이 만들어졌다
[XFAIL] 시스템 python3로 import cowsay — 예상된 실패 재현됨 (/No module named 'cowsay'/)
> ModuleNotFoundError: No module named 'cowsay'[PASS] venv/bin/python이 cowsay를 import한다 [PASS] venv/bin/python과 venv/bin/python3가 같은 인터프리터 파일로 이어진다 [PASS] venv/bin/python3도 venv를 sys.prefix로 쓴다 [PASS] venv/bin/python의 sys.prefix가 venv 폴더다 [PASS] venv/bin/python -m pip이 venv의 pip을 쓴다 [PASS] venv/bin/cowsay 출력을 얻었다 [PASS] venv/bin/cowsay를 경로로 바로 실행한다 [PASS] 설치된 스크립트 첫 줄을 읽었다 [PASS] 설치된 스크립트의 shebang이 venv의 python을 가리킨다 [PASS] shebang을 venv python으로 쓴 스크립트가 PATH를 비운 환경에서 돈다 [PASS] PATH를 비운 환경에서 venv/bin/python 직접 호출 [PASS] activate 뒤 command -v python 결과를 얻었다 [PASS] activate는 PATH 앞에 venv/bin을 붙여 python이 venv의 것이 된다
주의
- 설치된 명령과 shebang에는 가상환경 파이썬의 절대 경로가 들어간다. 가상환경 폴더를 옮기거나 복사하면 옛 경로를 가리키므로, 새 위치에서 환경을 다시 만들고 옛 폴더를 지운다. 가상환경은 다른 위치로 옮겨 쓰도록 만들어지지 않았다.
- cron에서는 상대 경로를 쓰지 않는다. 작업 디렉터리가 기대와 달라
venv/bin/python을 찾지 못한다. - 활성화가 필요한 경우도 있다. 가상환경의 명령을 이름만으로 부르고 싶거나, 다른 프로그램이
PATH에서python을 찾는 경우다. 그때는source venv/bin/activate를 쓴다.
자주 묻는 질문
activate를 하면 정확히 무엇이 달라지나?
PATH 앞에 가상환경의 bin 디렉터리가 붙는다. 그 결과 python과 설치된 명령을 이름만으로 부를 수 있다. 위 실행 결과에서도 activate 뒤 command -v python이 venv의 python을 가리켰다. 또 VIRTUAL_ENV 환경 변수가 가상환경 경로로 설정된다. 다만 활성화하지 않고도 가상환경을 쓸 수 있으므로, 이 변수만으로 가상환경을 쓰는 중인지 판단할 수는 없다.
venv/bin/python 대신 venv/bin/python3를 써도 되나?
써도 된다. 가상환경의 python과 python3는 같은 인터프리터 파일로 이어지고, venv/bin/python3로 실행해도 sys.prefix가 가상환경 폴더로 잡힌다(위 실행 결과).
Windows에서는 어떻게 하나?
공식 문서는 Windows의 바이너리 디렉터리를 bin이 아닌 Scripts로 안내한다. 같은 원리로 venv\Scripts\python.exe를 경로로 호출하는 방식이다.