설정 파일

Configuration files · 원문: docs.astral.sh/uv/concepts/configuration-files/

아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.

uv는 현재 디렉터리 또는 가장 가까운 상위 디렉터리에서 pyproject.toml 또는 uv.toml 파일을 검색하여 프로젝트 및 사용자 수준의 영구 설정을 지원합니다.

설정

사용 가능한 설정 옵션은 설정 참조 문서를 참고하세요.

uv run은 dotenvy 크레이트를 기반으로 dotenv 파일(.env, .env.local, .env.development)에서 환경 변수를 로드할 수 있습니다.

특정 위치의 .env 파일을 로드하려면 UV_ENV_FILE 환경 변수를 설정하거나 --env-file 플래그를 전달합니다:

코드 · 명령

$ echo "MY_VAR='Hello, world!'" > .env
$ uv run --env-file .env -- python -c 'import os; print(os.getenv("MY_VAR"))'
Hello, world!

--env-file 플래그는 여러 값을 허용하며, 나중 파일이 앞의 파일을 덮어씁니다. UV_ENV_FILE을 통한 여러 파일은 공백으로 구분해야 합니다(예: UV_ENV_FILE="/path/to/file1 /path/to/file2").

dotenv 로드를 비활성화하려면 UV_NO_ENV_FILE을 1로 설정하거나 uv run에 --no-env-file을 전달합니다. 환경 값은 .env 파일 값보다 우선합니다.

전용 [tool.uv.pip] 섹션은 uv pip 명령 인터페이스만 설정합니다. 여기서의 설정은 다른 uv 명령에는 적용되지 않지만, 최상위 설정에는 재정의되지 않는 한 uv pip에도 영향을 미치는 동등한 설정이 있을 수 있습니다.

uv pip만을 위한 설정 예시:

코드 · 명령

[tool.uv.pip]
index-url = "https://test.pypi.org/simple"

이 설정은 uv pip 하위 명령에는 영향을 미치지만 uv sync, uv lock, uv run에는 영향을 미치지 않습니다.

원문(영어): https://docs.astral.sh/uv/concepts/configuration-files/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.

문서 이동