pip install 옵션 정리

uv를 통해 uv pip install ~ 과 같은 형태로 사용하길 권함

많이 쓰는 pip install 옵션 정리

pip install은 Python package를 설치할 때 사용하는 기본 명령임.

 

기본 형태는 다음과 같음:

pip install package_name

 

특정 version을 지정할 수도 있음:

pip install requests==2.31.0

 

version 범위를 지정할 수도 있음:

pip install "numpy>=1.24,<2.0"

 

2023.06.30 - [Python] - [Python] pip 사용법

[Python] pip 사용법

---

1. -r: requirements.txt 기준 설치

pip install -r requirements.txt

• requirements.txt에 적힌 package들을 한 번에 설치함.
• --requirement 가 long option임.

requirements.txt가 다음과 같은 형식을 따름(package는 상황에 따라 다름에 유의):

requests==2.31.0
numpy>=1.24,<2.0
pandas

• requests==2.31.0: requests 2.31.0을 정확히 설치
• numpy>=1.24,<2.0: numpy 1.24 이상, 2.0 미만 설치
• pandas: 사용 가능한 최신 stable version 설치

현재 environment에 설치된 package 목록을 requirements.txt로 저장하려면 다음을 사용함.

pip freeze > requirements.txt

다른 environment에서 동일하게 설치하려면 다음처럼 실행함.

pip install -r requirements.txt

---

2. -e: editable mode 설치

pip install -e .

• 현재 directory의 package를 editable mode로 설치함.
• long option은 --editable 임.
• 일반 설치는 package를 environment의 site-packages에 복사해서 설치하는 방식임.
• 반면 editable mode는 현재 source directory를 참조하도록 설치함.
• 따라서 source code를 수정하면 재설치 없이 바로 반영됨.

개발 중인 package에서 많이 사용함.

2025.12.21 - [Python] - 개발 디렉토리를 pip package로 설치하기 - pip install -e .

개발 디렉토리를 pip package로 설치하기 - pip install -e .

---

3. -U: package upgrade ***

pip install -U requests

• -U는 --upgrade (long option)와 같음.
• 즉, 이미 설치된 package를 가능한 최신 version으로 upgrade함.

풀어 쓰면 다음과 같음.

pip install --upgrade requests

---

4. -i: package index 변경 **

pip install -i https://test.pypi.org/simple/ del-vscode

• 기본 package index를 바꿈.
• long option은 --index-url 임.

기본값은 PyPI 를 가리키는 다음의 index임:

https://pypi.org/simple/

• Python packaging 표준에서 정의된 “simple repository API”를 가리킴.
• simple은 Simple Repository API를 의미
• 즉, 사람이 보기 좋은 웹페이지가 아니라 installer가 파싱하기 쉬운 최소 HTML index임.
• 인간을 위한 URL은 https://pypi.org/project/ 임.

예를 들어 TestPyPI에 올린 package를 설치하려면 다음처럼 사용함.

pip install -i https://test.pypi.org/simple/ del-vscode

 

TestPyPI는

• PyPI에 실제 배포하기 전에
• package 업로드와 설치 과정을 안전하게 시험해볼 수 있는
• Python package 배포용 테스트 저장소임.

https://test.pypi.org/

TestPyPI · 파이썬 패키지 인덱스

---

5. --extra-index-url: 추가 package index 지정 ***

pip install \
  -i https://test.pypi.org/simple/ \
  --extra-index-url https://pypi.org/simple/ \
  del-vscode

추가 package index를 지정함.

• TestPyPI에는 내가 올린 package만 있고,
• dependency들은 정식 PyPI에 있는 경우.
• 이같은 경우가 흔함.

이 경우 다음과 같이 사용:.

pip install \
  -i https://test.pypi.org/simple/ \
  --extra-index-url https://pypi.org/simple/ \
  del-vscode

의미는 다음과 같음.

• del-vscode는 TestPyPI에서 찾음
• dependency는 PyPI에서도 찾음

---

6. --no-deps: dependency 설치 안 함

pip install --no-deps package

• 지정한 package만 설치하고 dependency는 자동 설치하지 않음.
• 이미 dependency를 별도로 설치해두었거나, dependency를 직접 관리하고 싶을 때 사용.

---

7. --force-reinstall: 강제 재설치

pip install --force-reinstall package

• 이미 같은 version이 설치되어 있어도 다시 설치함.
• package 설치가 꼬였거나, 같은 version을 다시 덮어씌우고 싶을 때 사용.

---

8. --no-cache-dir: cache 없이 설치

pip install --no-cache-dir package

• pip cache를 사용하지 않고 새로 다운로드해서 설치함.
• Docker image를 만들 때 image size를 줄이기 위해 자주 사용.

---

9. --user: 사용자 영역에 설치

pip install --user package

System Python 전체가 아니라 현재 사용자 계정 영역에 package를 설치.

 

주의할 점은

• pip install은 import되는 Python package만 설치하는 것이 아니라,
• package가 command를 제공하는 경우 실행 파일도 함께 설치함.

예를 들어 package가 다음처럼 command를 선언하고 있으면:

[project.scripts]
del-vscode = "del_vscode.cli:main"

 

설치 시 다음처럼 나뉘어 설치됨.

site-packages/  # import되는 Python package/module
Scripts/bin     # terminal에서 실행하는 command

 

Windows의 --user 설치 위치는 보통 다음과 같음:

Package:
C:\Users\<사용자이름>\AppData\Roaming\Python\PythonXY\site-packages

Command:
C:\Users\<사용자이름>\AppData\Roaming\Python\PythonXY\Scripts

• XY는 버전임: Python 3.11 의 경우 Python311

Linux/macOS의 --user 설치 위치는 보통 다음 계열임.

Package:
~/.local/lib/pythonX.Y/site-packages

Command:
~/.local/bin

실제 경로는 다음으로 확인 가능함.

python -m site --user-site
python -m site --user-base

• command가 설치되는 경로는 --user-base 밑의 Scripts 또는 bin이라고 보면 됨.
• user-site는 user-base 밑의 site-packages 임.

실행 파일 위치는 다음으로도 확인 가능:

# Windows CMD
where command_name

# PowerShell
Get-Command command_name

# Linux/macOS
which command_name

 

참고로,

• 일반적으로 virtual environment나 conda environment 안에서는 --user를 사용하지 않음.
• 이미 이들의 경우 환경에서 격리한 상태임.

---

요약

pip install package
pip install package==1.2.3
pip install "package>=1.0,<2.0"
pip install -r requirements.txt
pip install -e .
pip install -U package
pip install -i https://test.pypi.org/simple/ package
pip install --no-deps package
pip install --force-reinstall package
pip install --no-cache-dir package

---

같이보면 좋은 자료들

2023.06.30 - [Python] - [Python] pip 사용법

[Python] pip 사용법

2025.12.21 - [Python] - PyPI에 wheel을 업로드하기-pip 이용

PyPI에 wheel을 업로드하기-pip 이용

 

---