2026년 10월 10일 (토) 09:19에 Devcafe님의 편집

2026-10-10T09:19:11Z

← 이전 판		2026년 10월 10일 (토) 18:19 판
22번째 줄:		22번째 줄:
	pip install pyenv-win --target $HOME\.pyenv		pip install pyenv-win --target $HOME\.pyenv
	</source>		</source>
			----
	=== 셸 설정 ===		=== 셸 설정 ===

37번째 줄:		37번째 줄:
	exec "$SHELL"		exec "$SHELL"
	</source>		</source>
			----
	=== 빌드 의존성 설치 (Linux 필수) ===		=== 빌드 의존성 설치 (Linux 필수) ===

51번째 줄:		51번째 줄:

	macOS는 `xcode-select --install`로 충분한 경우가 많습니다.		macOS는 `xcode-select --install`로 충분한 경우가 많습니다.
			----
	=== 기본 명령어===		=== 기본 명령어===

67번째 줄:		67번째 줄:
	</source>		</source>

			----
	~~## 5.~~ 버전 지정 방법		=== 버전 지정 방법===
	{\| class="wikitable"		{\| class="wikitable"
	\|+ 파이썬 버전 지정하는 방법		\|+ 파이썬 버전 지정하는 방법
85번째 줄:		85번째 줄:
	pyenv which python		pyenv which python
	</source>		</source>
			----
	=== 가상환경 (pyenv-virtualenv) ===		=== 가상환경 (pyenv-virtualenv) ===

119번째 줄:		119번째 줄:
	source .venv/bin/activate		source .venv/bin/activate
	</source>		</source>
			----

	=== 업데이트 ==		=== 업데이트 ==
	<source lang=bash>		<source lang=bash>
130번째 줄:		129번째 줄:

	* 새 Python 버전이 목록에 안 보이면 pyenv 자체를 업데이트해야 합니다.		* 새 Python 버전이 목록에 안 보이면 pyenv 자체를 업데이트해야 합니다.
			----
	=== 자주 발생하는 문제 ===		=== 자주 발생하는 문제 ===

Devcafe: /* 설치 */

2026-10-10T09:18:01Z

설치

← 이전 판		2026년 10월 10일 (토) 18:18 판
4번째 줄:		4번째 줄:
	=== 설치 ===		=== 설치 ===

	macOS (Homebrew)		*macOS (Homebrew)
	<source lang=bash>		<source lang=bash>
	brew update		brew update
10번째 줄:		10번째 줄:
	</source>		</source>

	Linux		*Linux
	<source lang=bash>		<source lang=bash>
	curl https://pyenv.run \| bash		curl https://pyenv.run \| bash
	</source>		</source>

	Windows: 별도 프로젝트인 pyenv-win을 사용합니다.		*Windows: 별도 프로젝트인 pyenv-win을 사용합니다.
	<source lang=bash>		<source lang=bash>
	```powershell		```powershell

Devcafe: 새 문서: == pyenv 사용법== * pyenv는 여러 Python 버전을 설치하고 프로젝트별로 전환해 주는 도구입니다. === 설치 === macOS (Homebrew) brew update brew install pyenv Linux curl https://pyenv.run | bash Windows: 별도 프로젝트인 pyenv-win을 사용합니다. ```powershell choco install pyenv-win # 또는 pip install pyenv-win --target $HOME\.pyenv ===...

2026-10-10T09:17:30Z

새 문서: == pyenv 사용법== * pyenv는 여러 Python 버전을 설치하고 프로젝트별로 전환해 주는 도구입니다. === 설치 === **macOS (Homebrew)** <source lang=bash> brew update brew install pyenv </source> **Linux** <source lang=bash> curl https://pyenv.run | bash </source> **Windows**: 별도 프로젝트인 pyenv-win을 사용합니다. <source lang=bash> ```powershell choco install pyenv-win # 또는 pip install pyenv-win --target $HOME\.pyenv </source> ===...

새 문서

== pyenv 사용법==
* pyenv는 여러 Python 버전을 설치하고 프로젝트별로 전환해 주는 도구입니다.

=== 설치 ===

**macOS (Homebrew)**
<source lang=bash>
brew update
brew install pyenv
</source>

**Linux**
<source lang=bash>
curl https://pyenv.run | bash
</source>

**Windows**: 별도 프로젝트인 pyenv-win을 사용합니다.
<source lang=bash>
```powershell
choco install pyenv-win
# 또는
pip install pyenv-win --target $HOME\.pyenv
</source>

=== 셸 설정 ===

`~/.zshrc` 또는 `~/.bashrc`에 추가합니다.

<source lang=bash>
export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init - zsh)" # bash라면 "bash"
</source>

적용:
<source lang=bash>
exec "$SHELL"
</source>

=== 빌드 의존성 설치 (Linux 필수) ===

pyenv는 소스에서 Python을 컴파일하기 때문에 필요한 패키지가 있어야 합니다.

**Ubuntu/Debian**
<source lang=bash>
sudo apt update
sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev curl git libncursesw5-dev \
xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
</source>

macOS는 `xcode-select --install`로 충분한 경우가 많습니다.

=== 기본 명령어===

<source lang=bash>
pyenv install --list # 설치 가능한 버전 목록
pyenv install 3.12.4 # 특정 버전 설치
pyenv versions # 설치된 버전 목록
pyenv version # 현재 사용 중인 버전
pyenv uninstall 3.12.4 # 삭제
</source>

버전 목록 필터링:
<source lang=bash>
pyenv install --list | grep " 3\.12"
</source>

## 5. 버전 지정 방법
{| class="wikitable"
|+ 파이썬 버전 지정하는 방법
|-
! 전역 !! `pyenv global 3.12.4` !! 기본 Python 버전
|-
| 디렉터리 || `pyenv local 3.11.9` || 현재 폴더에 `.python-version` 파일 생성
|-
| 세션 || `pyenv shell 3.10.14` || 현재 터미널 세션에서만 적용
|}
* 우선순위는 `shell` > `local` > `global`입니다.

확인:
<source lang=bash>
python --version
pyenv which python
</source>

=== 가상환경 (pyenv-virtualenv) ===

* 설치
<source lang=bash>

# Homebrew
brew install pyenv-virtualenv

# Linux (pyenv.run으로 설치했다면 이미 포함됨)
git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
</source>

* 셸 설정에 추가:
<source lang=bash>

eval "$(pyenv virtualenv-init -)"
</source>

* 사용
<source lang=bash>
pyenv virtualenv 3.12.4 myenv # 생성
pyenv activate myenv # 활성화
pyenv deactivate # 비활성화
pyenv local myenv # 폴더 진입 시 자동 활성화
pyenv virtualenv-delete myenv # 삭제
</source>

* 가상환경이 필요한 것뿐이라면 pyenv로 버전을 고르고 표준 `venv`를 써도 됩니다.
<source lang=bash>
pyenv local 3.12.4
python -m venv .venv
source .venv/bin/activate
</source>

=== 업데이트 ==
<source lang=bash>

brew upgrade pyenv # Homebrew
pyenv update # pyenv.run으로 설치한 경우
</source>

* 새 Python 버전이 목록에 안 보이면 pyenv 자체를 업데이트해야 합니다.

=== 자주 발생하는 문제 ===

:- **`pyenv: command not found`**: 셸 설정 파일에 PATH/init 설정이 빠졌거나 셸을 재시작하지 않은 경우입니다.
:- **설치 중 `BUILD FAILED`**: 빌드 의존성이 부족한 경우가 대부분입니다. 3번 항목을 다시 확인하세요.
:- **버전을 바꿨는데 적용이 안 됨**: `pyenv versions`로 `*` 표시를 확인하고, `which python`이 `~/.pyenv/shims/python`을 가리키는지 확인하세요.
:- **새로 설치한 패키지 명령어가 인식 안 됨**: `pyenv rehash`를 실행하세요.

* 간단한 워크플로 예시

<source lang=bash>
pyenv install 3.12.4
mkdir myproject && cd myproject
pyenv local 3.12.4
python -m venv .venv
source .venv/bin/activate
pip install requests
</source>

[[category:python]]

Pyenv 파이썬 가상화 - 편집 역사

2026년 10월 10일 (토) 09:19에 Devcafe님의 편집

Devcafe: /* 설치 */