Mac中pyenv的安裝與使用教程
前言
pyenv 可在不同 python 版本之間輕松切換，實現 python 環境隔離，且支持自動激活和退出虛擬環境
一、pyenv
1、安裝
方式一：Git Clone
git clone git://github.com/pyenv/pyenv.git ~/.pyenv
bash
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc echo 'export PATH="$PYENV_ROOT/shims:$PATH"' >> ~/.bashrc echo 'eval "$(pyenv init -)"' >> ~/.bashrc exec $SHELL -l
zsh
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc echo 'export PATH="$PYENV_ROOT/shims:$PATH"' >> ~/.zshrc echo 'eval "$(pyenv init -)"' >> ~/.zshrc exec $SHELL -l
方式二：Homebrew
安裝
brew install pyenv
根據自身環境，將下方內容加到對應文件中： .bashrc / .zshrc
export PYENV_ROOT=/usr/local/var/pyenv export PATH="$PYENV_ROOT/bin:$PATH" export PATH="$PYENV_ROOT/shims:$PATH" if which pyenv > /dev/null; then eval "$(pyenv init -)"; fi
2、驗證
驗證安裝是否成功：
pyenv
3、使用
基本使用
| 命令 | 描述 |
|---|---|
| pyenv –version | 查看 pyenv 的版本 |
| pyenv versions | 羅列當前已安裝的所有 python 環境，如果是當前正在使用的環境，則前面會有個 * |
| pyenv help | 查看幫助 |
| pyenv init | 如果輸入 pyenv 之後使用 tab 不補全，可以使用該命令進行初始即可使用補全命令 |
安裝環境
| 命令 | 描述 |
|---|---|
| pyenv install -l | 顯示可以安裝的版本列表 |
| pyenv install 版本號 | 安裝指定版本的 python |
| pyenv rehash | 更新本地數據庫，安裝指定版本的 python 後使用 |
環境應用
| 命令 | 描述 |
|---|---|
| pyenv global 版本號 | 更改本機版本，重啟不會造成再次更改 |
| pyenv local 版本號 | 會在當前目錄創建 .python-version 文件，並記錄設置的 python 環境，每次進入該目錄會自動設置成該 python 環境 |
| pyenv shell 版本號 | 更改當前 shell 下使用的 python 版本，臨時生效，優先級高於 global |
二、virtualenv插件
1、安裝
方式一：Git Clone
cd .pyenv/plugins git clone https://github.com/pyenv/pyenv-virtualenv.git # 安裝virtualenv插件
方式二：Homebrew
brew install pyenv-virtualenv
2、配置
無論使用上述的哪種方式進行的安裝，請根據自身環境，將下方內容加到對應文件中： .bashrc / .zshrc
eval "$(pyenv virtualenv-init -)"
3、使用
基本使用
| 命令 | 描述 |
|---|---|
| pyenv virtualenv 3.8.3 env383 | 創建 3.8.3 版本虛擬環境 |
| pyenv virtualenvs | 顯示環境 |
| pyenv activate env383 | 激活使用指定的虛擬環境 |
| pyenv deactivate | 退出當前虛擬環境 |
| rm -rf .pyenv/versions/3.8.3 | 刪除版本環境 |
| rm -rf .pyenv/versions/env383 | 刪除虛擬環境 |
自動激活和退出虛擬環境
在需要使用虛擬環境的目錄（通常是項目目錄）中：
- 建立一個 .python-version 的文本文件
- 將虛擬環境名稱（如 env383 ）寫在裡面
之後每次進／出該目錄時，虛擬環境都將自動激活／退出。
三、報錯
1、激活指定的虛擬環境時報錯
# 命令 pyenv activate env383 # 報錯信息 Failed to activate virtualenv. Perhaps pyenv-virtualenv has not been loaded into your shell properly. Please restart current shell and try again.
別慌，重啟你的終端，或者執行如下命令即可
exec $SHELL -l
2、還是系統版本
如果你用 pyenv versions 查看，明明已經切換成功，但是用 python -V卻還是系統版本。
原因是 pyenv沒有加到 $PATH環境變量裡去，解決辦法如下：
export PYENV_ROOT=~/.pyenv export PATH=$PYENV_ROOT/shims:$PATH
3、安裝 python報錯
安裝 python報錯，如
pyenv install 3.8.3
報錯內容：
python-build: use [email protected] from homebrew python-build: use readline from homebrew Downloading Python-3.8.3.tar.xz... -> https://www.python.org/ftp/python/3.8.3/Python-3.8.3.tar.xz Installing Python-3.8.3... python-build: use readline from homebrew python-build: use zlib from xcode sdk BUILD FAILED (OS X 12.0.1 using python-build 20180424) Inspect or clean up the working tree at /var/folders/cy/8zkx5hys2tsgb1d_x42_r8qc0000gn/T/python-build.20220122174148.1531 Results logged to /var/folders/cy/8zkx5hys2tsgb1d_x42_r8qc0000gn/T/python-build.20220122174148.1531.log Last 10 log lines: clang -Wno-unused-result -Wsign-compare -Wunreachable-code -DNDEBUG -g -fwrapv -O3 -Wall -I/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include -I/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include -std=c99 -Wextra -Wno-unused-result -Wno-unused-parameter -Wno-missing-field-initializers -Wstrict-prototypes -Werror=implicit-function-declaration -I./Include/internal -I. -I./Include -I/usr/local/opt/readline/include -I/usr/local/opt/readline/include -I/usr/local/var/pyenv/versions/3.8.3/include -I/usr/local/opt/sqlite/include -I/usr/local/opt/readline/include -I/usr/local/opt/readline/include -I/usr/local/var/pyenv/versions/3.8.3/include -I/usr/local/opt/sqlite/include -DPy_BUILD_CORE_BUILTIN -c ./Modules/_codecsmodule.c -o Modules/_codecsmodule.o clang -Wno-unused-result -Wsign-compare -Wunreachable-code -DNDEBUG -g -fwrapv -O3 -Wall -I/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include -I/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include -std=c99 -Wextra -Wno-unused-result -Wno-unused-parameter -Wno-missing-field-initializers -Wstrict-prototypes -Werror=implicit-function-declaration -I./Include/internal -I. -I./Include -I/usr/local/opt/readline/include -I/usr/local/opt/readline/include -I/usr/local/var/pyenv/versions/3.8.3/include -I/usr/local/opt/sqlite/include -I/usr/local/opt/readline/include -I/usr/local/opt/readline/include -I/usr/local/var/pyenv/versions/3.8.3/include -I/usr/local/opt/sqlite/include -DPy_BUILD_CORE_BUILTIN -c ./Modules/_weakref.c -o Modules/_weakref.o ./Modules/posixmodule.c:9221:15: error: implicit declaration of function 'sendfile' is invalid in C99 [-Werror,-Wimplicit-function-declaration] ret = sendfile(in, out, offset, &sbytes, &sf, flags); ^ clang -Wno-unused-result -Wsign-compare -Wunreachable-code -DNDEBUG -g -fwrapv -O3 -Wall -I/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include -I/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include -std=c99 -Wextra -Wno-unused-result -Wno-unused-parameter -Wno-missing-field-initializers -Wstrict-prototypes -Werror=implicit-function-declaration -I./Include/internal -I. -I./Include -I/usr/local/opt/readline/include -I/usr/local/opt/readline/include -I/usr/local/var/pyenv/versions/3.8.3/include -I/usr/local/opt/sqlite/include -I/usr/local/opt/readline/include -I/usr/local/opt/readline/include -I/usr/local/var/pyenv/versions/3.8.3/include -I/usr/local/opt/sqlite/include -DPy_BUILD_CORE_BUILTIN -DPy_BUILD_CORE_BUILTIN -I./Include/internal -c ./Modules/_functoolsmodule.c -o Modules/_functoolsmodule.o 1 error generated. make: *** [Modules/posixmodule.o] Error 1 make: *** Waiting for unfinished jobs.... 1 warning generated.
使用下面的命令安裝即可，註意修改成相應的版本號
CFLAGS="-I$(brew --prefix openssl)/include -I$(brew --prefix bzip2)/include -I$(brew --prefix readline)/include -I$(xcrun --show-sdk-path)/usr/include" LDFLAGS="-L$(brew --prefix openssl)/lib -L$(brew --prefix readline)/lib -L$(brew --prefix zlib)/lib -L$(brew --prefix bzip2)/lib" pyenv install --patch 3.8.3 < <(curl -sSL https://github.com/python/cpython/commit/8ea6353.patch\?full_index\=1)
四、註意
- 安裝好的版本不做任何修改，我們隻操作虛擬環境，如 env383
- 可以通過版本來多個虛擬環境，如 env383_1、env383_2
- 導出當前環境的依賴庫: pip freeze > requirements.txt
- 導入依賴庫到當前環境: pip install -r requirements.txt
五、相關知識
5.1、pyenv能做什麼
1，基於每個用戶更改全局Python版本
2，對每個項目的Python版本提供支持
3，允許通過環境變量覆蓋Python版本
4，一次搜索多個版本的Python
5.2、pyenv運行
在一個高的級別上，pyenv使用shim可執行文件註入到PATH來攔截Python命令；確定您的應用程序指定瞭哪個Python版本，並將命令傳遞給正確的已安裝Python版本。
5.3、PATH
當運行諸如python或pip等命令時，操作系統將在目錄列表中搜索以查找具有該名稱的可執行文件。此目錄列表位於一個名為PATH的環境變量中，列表中的每個目錄都用冒號分隔：
/usr/local/bin:/usr/bin:/bin
PATH從左到右搜索目錄，因此列表開頭目錄中的匹配可執行文件優先於結尾目錄中的另一個可執行文件。在這個例子中， /usr/local/bin目錄將被搜索的第一個，然後是/usr/bin，然後是/bin。
5.4、shims
pyenv通過在你的PATH前插入shims目錄來工作：
$(pyenv root)/shims:/usr/local/bin:/usr/bin:/bin
Shim是輕量級的可執行文件，它們隻是將命令傳遞給pyenv。因此在安裝瞭pyenv的情況下，運行pip時操作系統將執行以下操作：
1，在PATH中搜索名稱為pip的可執行文件
2，在PATH開頭的shims目錄中，找到名稱為pip的shim文件
3，運行名稱為pip的shime文件，shime將命令傳遞給pyenv
總結
到此這篇關於Mac中pyenv的安裝與使用的文章就介紹到這瞭,更多相關Mac pyenv安裝使用內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！
推薦閱讀：
- 一文解決Python切換版本問題
- 一文讀懂Python版本管理工具Pyenv使用
- 總結Python使用過程中的bug
- Mac M1安裝Homebrew的方法步驟
- go語言-在mac下brew升級golang