一、這個問題是什么？

在 macOS 上使用 Homebrew 安裝的 Python 時，如果直接執(zhí)行：

bash pip install xxx

可能會遇到類似下面的報錯：

bash error: externally-managed-environment

這是因為當(dāng)前 Python 環(huán)境是由 Homebrew 管理的，系統(tǒng)不建議直接往全局 Python 環(huán)境里安裝第三方依賴，否則可能會把 Python 環(huán)境弄亂。

正確做法是：在項目里創(chuàng)建一個獨立的 Python 虛擬環(huán)境。

虛擬環(huán)境可以理解為：

每個項目都有自己單獨的一套 Python 依賴，不影響系統(tǒng)，也不影響其他項目。

二、第一次使用：創(chuàng)建虛擬環(huán)境

第一次進(jìn)入項目時，需要先創(chuàng)建虛擬環(huán)境。

1. 進(jìn)入項目目錄

假設(shè)你的項目文件夾叫 my-project，先進(jìn)入這個目錄：

bash cd my-project

例如：

bash cd /Users/你的用戶名/Desktop/my-project

2. 創(chuàng)建虛擬環(huán)境

執(zhí)行：

bash python3 -m venv .venv

這條命令的意思是：

• python3：使用 Python 3
• -m venv：使用 Python 自帶的虛擬環(huán)境模塊
• .venv：創(chuàng)建一個名為 .venv 的虛擬環(huán)境文件夾

創(chuàng)建成功后，項目目錄里會多出一個 .venv 文件夾。

注意：
這一步只需要第一次執(zhí)行一次。

以后只要 .venv 文件夾還在，就不需要重復(fù)創(chuàng)建。

3. 激活虛擬環(huán)境

創(chuàng)建完成后，需要激活虛擬環(huán)境：

bash source .venv/bin/activate

激活成功后，終端前面一般會出現(xiàn)：

bash (.venv)

例如：

bash (.venv) user@MacBook my-project %

看到 (.venv) 就說明當(dāng)前已經(jīng)進(jìn)入虛擬環(huán)境了。

4. 安裝項目依賴

如果項目里有 requirements.txt，執(zhí)行：

bash python3 -m pip install -r requirements.txt

如果項目是離線安裝，并且有本地依賴包目錄，比如 packages，可以執(zhí)行：

bash python3 -m pip install --no-index --find-links ./packages -r requirements.txt

如果項目有自己的安裝腳本，例如：

bash ./安裝依賴.sh

或者：

bash ./install.sh

也可以在激活虛擬環(huán)境后運(yùn)行。

5. 啟動項目

依賴安裝完成后，再啟動項目。

例如：

bash ./啟動服務(wù).sh

或者根據(jù)項目實際情況執(zhí)行：

bash python3 app.py

bash python3 main.py

bash npm run dev

具體啟動命令要看項目提供的說明。

三、以后每次打開終端都怎么做？

以后不需要重新創(chuàng)建 .venv。

每次重新打開終端，只需要做這幾步：

1. 進(jìn)入項目目錄

bash cd 項目目錄

例如：

bash cd /Users/你的用戶名/Desktop/my-project

2. 激活虛擬環(huán)境

bash source .venv/bin/activate

看到終端前面出現(xiàn) (.venv)，說明已經(jīng)進(jìn)入虛擬環(huán)境。

3. 啟動服務(wù)

bash ./啟動服務(wù).sh

如果項目啟動命令不是這個，就換成項目真實的啟動命令。

四、完整示例

假設(shè)項目在桌面上的 my-project 文件夾里。

第一次使用

bash cd ~/Desktop/my-project python3 -m venv .venv source .venv/bin/activate python3 -m pip install -r requirements.txt ./啟動服務(wù).sh

以后每次使用

bash cd ~/Desktop/my-project source .venv/bin/activate ./啟動服務(wù).sh

五、為什么每次都要 source .venv/bin/activate？

因為：

bash python3 -m venv .venv

是創(chuàng)建虛擬環(huán)境。

而：

bash source .venv/bin/activate

是激活虛擬環(huán)境。

創(chuàng)建虛擬環(huán)境只需要一次，但激活虛擬環(huán)境是針對當(dāng)前終端窗口生效的。

也就是說：

• 你打開一個終端，需要激活一次
• 你關(guān)閉終端后，虛擬環(huán)境狀態(tài)就沒了
• 下次重新打開終端，需要再次執(zhí)行 source .venv/bin/activate

虛擬環(huán)境文件夾 .venv 還在，不代表當(dāng)前終端已經(jīng)進(jìn)入了虛擬環(huán)境。

六、怎么判斷自己有沒有進(jìn)入虛擬環(huán)境？

看終端前面有沒有：

bash (.venv)

例如：

bash (.venv) user@MacBook my-project %

如果有，說明已經(jīng)進(jìn)入虛擬環(huán)境。

如果沒有，說明還沒有進(jìn)入，需要執(zhí)行：

bash source .venv/bin/activate

七、怎么退出虛擬環(huán)境？

如果想退出虛擬環(huán)境，執(zhí)行：

bash deactivate

退出后，終端前面的 (.venv) 會消失。

八、常見問題

1. 我已經(jīng)創(chuàng)建過 .venv，還需要重新創(chuàng)建嗎？

不需要。

只要項目目錄里的 .venv 文件夾還在，就不用重新執(zhí)行：

bash python3 -m venv .venv

只需要執(zhí)行：

bash source .venv/bin/activate

2. 我關(guān)掉終端后，為什么又沒有 (.venv) 了？

這是正常的。

虛擬環(huán)境的激活狀態(tài)只對當(dāng)前終端窗口有效。

關(guān)閉終端后，下次打開需要重新執(zhí)行：

bash source .venv/bin/activate

3. 為什么我激活虛擬環(huán)境后，pip install 就不報錯了？

因為依賴會安裝到項目自己的 .venv 文件夾里，而不是安裝到 Homebrew 管理的全局 Python 環(huán)境里。

這樣不會破壞系統(tǒng) Python，也不會影響其他項目。

4. 如果提示沒有 requirements.txt 怎么辦？

說明項目可能沒有提供 requirements.txt 文件。

可以先查看項目目錄里有沒有類似文件：

bash ls

常見依賴文件可能叫：

bash requirements.txt pyproject.toml Pipfile environment.yml

如果都沒有，就需要看項目說明文檔，確認(rèn)應(yīng)該安裝哪些依賴。

5. 如果 source .venv/bin/activate 報錯怎么辦？

可能是 .venv 還沒有創(chuàng)建，或者你不在項目目錄里。

可以先檢查當(dāng)前目錄：

bash pwd

再查看有沒有 .venv 文件夾：

bash ls -a

如果沒有 .venv，說明還沒創(chuàng)建，需要執(zhí)行：

bash python3 -m venv .venv

然后再執(zhí)行：

bash source .venv/bin/activate

九、可以讓啟動腳本自動進(jìn)入虛擬環(huán)境嗎？

可以。

如果你的項目每次都需要先激活虛擬環(huán)境再啟動，可以把啟動腳本改成自動激活。

例如編輯 啟動服務(wù).sh：

bash #!/bin/bash cd “$(dirname “$0”)” source .venv/bin/activate python3 app.py

其中：

bash python3 app.py

需要替換成你項目真實的啟動命令。

比如你的項目是：

bash python3 main.py

那就寫成：

bash #!/bin/bash cd “$(dirname “$0”)” source .venv/bin/activate python3 main.py

這樣以后只需要執(zhí)行：

bash ./啟動服務(wù).sh

腳本就會自動進(jìn)入虛擬環(huán)境并啟動項目。

十、推薦記住的三條命令

第一次創(chuàng)建虛擬環(huán)境：

bash python3 -m venv .venv

每次進(jìn)入虛擬環(huán)境：

bash source .venv/bin/activate

退出虛擬環(huán)境：

bash deactivate

十一、最簡單的記憶方式

第一次：

bash cd 項目目錄 python3 -m venv .venv source .venv/bin/activate 安裝依賴 啟動項目

以后每次：

bash cd 項目目錄 source .venv/bin/activate 啟動項目

一句話總結(jié)：

.venv 只需要創(chuàng)建一次，但每次重新打開終端，都需要重新激活一次。

以上就是Python虛擬環(huán)境venv使用說明詳解的詳細(xì)內(nèi)容，更多關(guān)于Python虛擬環(huán)境venv使用的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論