Search
๐Ÿ“ฆ

venv

Created
2026/02/26 15:34
Last edited time
2026/02/26 16:12
Category
Environment

Overview

๊ฐœ๋ฐœ์„ ํ•˜๋‹ค๋ณด๋ฉด ํšŒ์‚ฌ์—์„œ ์—…๋ฌด๋ฅผ ํ•  ๋•Œ๋„ ์žˆ๊ณ  ์‚ฌ์ด๋“œํ”„๋กœ์ ํŠธ๋ฅผ ํ•  ๋•Œ๋„ ์žˆ๋‹ค. ์—ฌ๋Ÿฌ ํ”„๋กœ์ ํŠธ๊ฐ€ ํ•˜๋‚˜์˜ ํ™˜๊ฒฝ์„ ๊ณต์œ ํ•˜๋ฉด ์ข‹๊ฒ ์ง€๋งŒ ํ˜„์‹ค์€ ๊ทธ๋ ‡์ง€ ์•Š๋‹ค. ์˜ค๋ž˜ ๋œ ํ”„๋กœ์ ํŠธ๋Š” ์œ ์ง€๋ณด์ˆ˜๊ฐ€ ์ œ ๋•Œ ์ด๋ฃจ์–ด์ง€์ง€ ์•Š์•„ ๋‚ฎ์€ ๋ฒ„์ „์˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•˜๊ณ  ์žˆ๋Š” ๊ฒฝ์šฐ๊ฐ€ ์žˆ๊ณ , ๊ทธ์— ๋ฐ˜ํ•ด ํ˜„์žฌ ํ™œ๋ฐœํžˆ ์ง„ํ–‰๋˜๊ณ  ์žˆ๋Š” ํ”„๋กœ์ ํŠธ๋Š” ๋น„๊ต์  ์ตœ์‹  ๋ฒ„์ „์˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์“ธ ์ˆ˜ ์žˆ์„ ๊ฐ€๋Šฅ์„ฑ์ด ๋†’๋‹ค.
๊ทธ๋ ‡๋‹ค๊ณ  ํ•ด์„œ, ์˜ค๋ž˜๋œ ํ”„๋กœ์ ํŠธ ์† ๊ตฌ๋ฒ„์ „์˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์ตœ์‹  ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธ ํ•˜๋ฉด ์ข‹๊ฒ ์ง€๋งŒ ๋จผ์ง€ ํ•œ ํ†จ๋งŒ ๊ฑท์–ด๋‚ด๋„ ๋ฒ„๊ทธ๊ฐ€ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ๊ธฐ ๋•Œ๋ฌธ์— ๋‘๋ ต๋‹ค. ๊ทธ๋ ‡๋‹ค๊ณ  ํ•ด์„œ ํ˜„์žฌ ๋‚ด ์ปดํ“จํ„ฐ์— ์„ค์น˜ ๋˜์–ด์žˆ๋Š” ๋‚ฎ์€ ๋ฒ„์ „์˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•ด ํ˜„์žฌ ํ™œ๋ฐœํžˆ ์ง„ํ–‰ ์ค‘์ธ ํ”„๋กœ์ ํŠธ์˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ฒ„์ „์„ ๋‚ฎ์ถœ ํ•„์š”๋„ ์—†๋‹ค.
์ด์™€ ๊ฐ™์ด ์„œ๋กœ ๋ถ„๋ฆฌ๋œ ํ™˜๊ฒฝ์ด ํ•„์š”ํ•œ ์ƒํ™ฉ์ด ๋ฐ˜๋“œ์‹œ ์กด์žฌํ•˜๋Š”๋ฐ, ํ•˜๋‚˜์˜ ์ปดํ“จํ„ฐ์—์„œ ๊ฐ ํ”„๋กœ์ ํŠธ๋งˆ๋‹ค ๋‹ค๋ฅธ ํ™˜๊ฒฝ์„ ๊ตฌ์„ฑํ•˜๊ณ ์‹ถ์„ ๋•Œ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์ด venv์ด๋‹ค. venv๋Š” ํ”„๋กœ์ ํŠธ๋งˆ๋‹ค ๋…๋ฆฝ์ ์ธ Python ์‹คํ–‰ ํ™˜๊ฒฝ์„ ๋งŒ๋“ค์–ด์ฃผ๋Š” ๋„๊ตฌ์ด๋‹ค.

Contents

ย Venv๋Š” ๋ฌด์—‡์ด๊ณ  ์™œ ์จ์•ผํ• ๊นŒ?

Venv๋Š” Virtual Environment์˜ ์•ฝ์ž๋กœ ํ”„๋กœ์ ํŠธ๋งˆ๋‹ค ๋…๋ฆฝ์ ์ธ Python ์‹คํ–‰ ํ™˜๊ฒฝ์„ ๋งŒ๋“ค์–ด์ฃผ๋Š” ๋„๊ตฌ์ด๋‹ค. ํ”„๋กœ์ ํŠธ๋งˆ๋‹ค ์‚ฌ์šฉํ•˜๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ๊ฒน์น  ๋•Œ ์ด ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” ํ•˜๋‚˜์ง€๋งŒ ํ”„๋กœ์ ํŠธ๋งˆ๋‹ค ๋‹ค๋ฅธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ฒ„์ „์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ฃผ๋Š” ๊ฐ€์ƒํ™˜๊ฒฝ์ด๋‹ค.
์˜ˆ๋ฅผ ๋“ค์–ด A ํ”„๋กœ์ ํŠธ์™€ B ํ”„๋กœ์ ํŠธ์—์„œ FastAPI ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค๊ณ  ํ–ˆ์„ ๋•Œ ๋‘ ํ”„๋กœ์ ํŠธ์—์„œ ์‚ฌ์šฉํ•˜๋Š” fastapi์˜ ๋ฒ„์ „์ด ๋‹ค๋ฅผ ์ˆ˜ ์žˆ๋‹ค.
ํ”„๋กœ์ ํŠธ A
fastapi==0.95
Plain Text
๋ณต์‚ฌ
ํ”„๋กœ์ ํŠธ B
fastapi==0.110
Plain Text
๋ณต์‚ฌ
์œ„์™€ ๊ฒฝ์šฐ, ๋‘ ๊ฐœ๋ฅผ ์ „์—ญ์œผ๋กœ ํ™˜๊ฒฝ์— ์„ค์น˜ํ•˜๊ฒŒ ๋˜๋ฉด ๋ฒ„์ „ ์ถฉ๋Œ์ด ๋ฐœ์ƒํ•œ๋‹ค. ํ•˜์ง€๋งŒ venv๋ฅผ ์“ฐ๊ฒŒ ๋˜๋ฉด ํ”„๋กœ์ ํŠธ๋งˆ๋‹ค ๊ฐ€์ƒ ํ™˜๊ฒฝ์„ ๊ตฌ์ถ•ํ•˜์—ฌ ์ถฉ๋Œ ์—†์ด ํ”„๋กœ์ ํŠธ๋งˆ๋‹ค ๋‹ค๋ฅธ ๋ฒ„์ „์˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋˜๋Š” ๊ฒƒ์ด๋‹ค.

ย Venv ์‚ฌ์šฉํ•˜๊ธฐ

venv๋Š” Python ๋‚ด์žฅ ๋ชจ๋“ˆ๋กœ Python์„ ์„ค์น˜ํ•˜๋ฉด ๊ธฐ๋ณธ์œผ๋กœ ๋“ค์–ด๊ฐ€์žˆ๋‹ค.
๊ฐ€์ƒํ™˜๊ฒฝ ์ƒ์„ฑ
# python -m venv <์ƒ์„ฑํ•  ํด๋” ์ด๋ฆ„> $ python -m venv .venv
Shell
๋ณต์‚ฌ
ํ™œ์„ฑํ™” (Mac/Linux)
# source <์ƒ์„ฑํ•œ ํด๋” ์ด๋ฆ„>/bin/activate $ source .venv/bin/activate
Shell
๋ณต์‚ฌ
ํ™œ์„ฑํ™” (Windows)
# <์ƒ์„ฑํ•œ ํด๋” ์ด๋ฆ„>\Scripts\activate $ .venv\Scripts\activate
Shell
๋ณต์‚ฌ
ํ™œ์„ฑํ™”๋ฅผ ํ•˜๋ฉด ๋ณดํ†ต ํ„ฐ๋ฏธ๋„์˜ ์ œ์ผ ์•ž์— ํ˜„์žฌ ํ™œ์„ฑํ™” ์ค‘์ธ ํ™˜๊ฒฝ ์ด๋ฆ„์ด ํ‘œ์‹œ ๋œ๋‹ค.
(.venv) chaminjae@macbookpro fastapi %
Shell
๋ณต์‚ฌ
ํ…Œ์ŠคํŠธ๋ฅผ ์œ„ํ•ด .venv2๋„ ๋งŒ๋“ค๊ณ  .venv๋ฅผ ํ™œ์„ฑํ™” ์‹œํ‚จ ํ›„ ํ˜„์žฌ ์„ค์น˜ ๋˜์–ด์žˆ๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ชฉ๋ก์„ ํ™•์ธ ํ•ด๋ณด์•˜๋‹ค.
$ python -m venv .venv2 $ source .venv/bin/activate (.venv) $ pip list Package Version ------- ------- pip 25.3
Shell
๋ณต์‚ฌ
.venv์— FastAPI์™€ uvicorn์„ ์„ค์น˜ํ•˜๊ณ , .venv์™€ .venv2์˜ pip list๋ฅผ ํ™•์ธ ํ•ด๋ณด์•˜๋‹ค.
.venv
Package Version ----------------- ------- annotated-doc 0.0.4 annotated-types 0.7.0 anyio 4.12.1 click 8.3.1 fastapi 0.133.1 h11 0.16.0 idna 3.11 pip 26.0.1 pydantic 2.12.5 pydantic_core 2.41.5 starlette 0.52.1 typing_extensions 4.15.0 typing-inspection 0.4.2 uvicorn 0.41.0
Shell
๋ณต์‚ฌ
.venv2
Package Version ------- ------- pip 25.3
Shell
๋ณต์‚ฌ
ํ™•์ธ ๊ฒฐ๊ณผ ํ•˜๋‚˜์˜ ์ปดํ“จํ„ฐ์—์„œ ์ž‘์—…์„ ํ•˜๊ณ  ์žˆ์Œ์—๋„ ๋ถˆ๊ตฌํ•˜๊ณ  ์„œ๋กœ ๋‹ค๋ฅธ ํ™˜๊ฒฝ์„ ๊ตฌ์ถ•ํ•˜์—ฌ ๊ฐœ๋ฐœ์„ ์ง„ํ–‰ํ•  ์ˆ˜ ์žˆ์Œ์„ ํ™•์ธํ–ˆ๋‹ค. ์ด์ฒ˜๋Ÿผ venv๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋‹ค๋ฅธ ํ”„๋กœ์ ํŠธ์™€์˜ ์ถฉ๋Œ์„ ๋ฐฉ์ง€ํ•˜๊ณ  ํŒ€์› ํ™˜๊ฒฝ์ด ๋‹ค๋ฅผ ์ˆ˜ ์žˆ์Œ์—๋„ ๋™์ผํ•œ ํ™˜๊ฒฝ์—์„œ ํ”„๋กœ์ ํŠธ๋ฅผ ์ง„ํ–‰ํ•  ์ˆ˜ ์žˆ๋‹ค. ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ๋งž์ถ”๋Š” ๊ฒƒ ์ž์ฒด๊ฐ€ ํ”ผ๊ณคํ•œ ์ผ์ธ๋ฐ, ์ด์ฒ˜๋Ÿผ ์ฒ˜์Œ๋ถ€ํ„ฐ ๊ฐ€์ƒ ํ™˜๊ฒฝ์„ ์ƒ์„ฑํ•˜์—ฌ ํ”„๋กœ์ ํŠธ๋ฅผ ์ง„ํ–‰ํ•˜๋ฉด ์‚ฌ๊ณ ๋ฅผ ์ค„์ผ ์ˆ˜ ์žˆ๋Š” ์ด์ ์ด ์žˆ๋‹ค.

๊ธฐํƒ€

๊ฐ€์ƒํ™˜๊ฒฝ ๋น ์ ธ๋‚˜์˜ค๊ธฐ
$ deactivate
Shell
๋ณต์‚ฌ