uv 기본 사용법 완벽 가이드: 가상환경 생성부터 패키지 관리까지

파이썬 프로젝트를 효율적으로 관리하기 위해 uv를 설치했다면 이제 그 강력한 기능을 활용해볼 차례입니다. uv는 가상환경 생성, 패키지 설치, 의존성 관리 등 다양한 작업을 간단하고 빠르게 처리할 수 있는 도구입니다. 이번 글에서는 uv의 기본 사용법을 친절히 설명하며 따라 하기 쉬운 예제 코드와 함께 소개하겠습니다.

uv 기본 사용법 완벽 가이드

 

uv로 가상환경 생성하기

가상환경은 파이썬 프로젝트마다 독립적인 환경을 제공하여 패키지 충돌을 방지하고 관리 효율성을 높여줍니다. uv를 사용하면 가상환경 생성이 매우 간편합니다.

가상환경 생성

uv를 사용하여 새로운 가상환경을 생성하려면 다음 명령어를 실행하세요:

uv venv create my_project_env

위 명령은 my_project_env라는 이름의 가상환경을 생성합니다. 원하는 이름으로 변경하여 사용할 수 있습니다.

생성된 가상환경 활성화

가상환경을 활성화하려면 다음 명령어를 실행합니다:

uv venv activate my_project_env

활성화된 상태에서는 해당 가상환경에 설치된 패키지만 접근할 수 있습니다.

가상환경 비활성화

가상환경에서 빠져나오고 싶다면 다음 명령어를 사용하세요:

uv venv deactivate

이 명령은 현재 활성화된 가상환경을 비활성화합니다.

uv로 패키지 설치 및 관리하기

uv는 패키지 설치와 의존성 관리를 매우 빠르고 간단하게 처리합니다.

패키지 설치

예를 들어, requests 라이브러리를 설치하려면 다음과 같이 실행합니다:

uv add requests

이 명령은 requests 라이브러리를 현재 활성화된 가상환경에 설치합니다.

특정 버전의 패키지 설치

특정 버전의 패키지를 설치하고 싶다면 다음과 같이 실행하세요:

uv add requests==2.28.1

위 명령은 requests 라이브러리의 2.28.1 버전을 설치합니다.

설치된 패키지 확인

현재 환경에 설치된 패키지를 확인하려면 다음 명령어를 사용합니다:

uv list

이 명령은 모든 설치된 패키지와 버전을 출력합니다.

패키지 제거

더 이상 필요하지 않은 패키지를 제거하려면 다음과 같이 실행하세요:

uv remove requests

이 명령은 requests 라이브러리를 환경에서 제거합니다.

의존성 파일 생성 및 관리

uv는 의존성 파일을 자동으로 생성하고 관리할 수 있습니다. 이를 통해 프로젝트의 재현성을 보장할 수 있습니다.

의존성 파일 생성

다음 명령어를 실행하면 현재 환경의 모든 의존성을 requirements.txt 파일로 저장할 수 있습니다:

uv export > requirements.txt

의존성 파일로부터 설치

다른 개발자가 동일한 환경을 설정하도록 하려면 requirements.txt 파일로부터 모든 의존성을 설치할 수 있습니다:

uv sync requirements.txt

이 명령은 requirements.txt에 정의된 모든 패키지를 현재 환경에 설치합니다.

uv로 Python 버전 관리하기

프로젝트마다 다른 Python 버전을 사용해야 할 때 uv는 매우 유용한 도구입니다.

Python 버전 확인

현재 시스템에서 사용할 수 있는 Python 버전을 확인하려면 다음 명령어를 실행하세요:

uv python list

Python 버전 변경

특정 프로젝트에서 다른 Python 버전을 사용하고 싶다면 다음과 같이 변경할 수 있습니다:

uv python use 3.11.4

위 명령은 Python 3.11.4 버전을 활성화합니다.

결론

uv는 파이썬 개발자들에게 필요한 모든 기능을 통합적으로 제공하며, 특히 속도와 효율성 면에서 뛰어난 성능을 자랑합니다. 이번 글에서는 uv로 가상환경 생성, 패키지 설치 및 관리, 그리고 Python 버전 변경 등 기본적인 사용법을 알아보았습니다.

다음 글에서는 pyproject.toml과 uv를 통합 활용하는 방법에 대해 심층적으로 다룰 예정입니다. uv를 통해 더욱 체계적이고 강력한 파이썬 프로젝트 관리 방법을 배워보세요!

uv와 pyproject.toml 통합 활용 완벽 가이드: 파이썬 프로젝트 관리의 새로운 패러다임

uv와 pyproject.toml 통합 활용 완벽 가이드: 파이썬 프로젝트 관리의 새로운 패러다임