前言：一個真實的問題引發(fā)的思考

前幾天，我在整理自己 Mac 電腦的 Python 環(huán)境時，遇到了一個讓人困惑的問題：

(chatgpt-on-wechat) cong@MacBook-Pro % which python
/opt/anaconda3/envs/chatgpt-on-wechat/bin/python

(chatgpt-on-wechat) cong@MacBook-Pro % which python3
/usr/bin/python3

明明已經(jīng)激活了 Conda 環(huán)境，python 命令指向了正確的環(huán)境路徑，但 python3 卻還是指向系統(tǒng)的 /usr/bin/python3。這意味著如果我在項目中使用 python3 來運行腳本，實際上用的根本不是我精心配置的 Conda 環(huán)境。

經(jīng)過一番排查，發(fā)現(xiàn)問題出在 ~/.zshrc 配置文件中的 PATH 優(yōu)先級設(shè)置。這個小插曲讓我意識到：Mac 上的 Python 環(huán)境管理，遠比想象中復(fù)雜。系統(tǒng)自帶的、Homebrew 安裝的、Conda 管理的，再加上 python 和 python3 的區(qū)別、pip 和 pip3 的差異……如果沒有一個清晰的認知框架，很容易在各種環(huán)境中迷失。

這篇文章就來系統(tǒng)地聊聊 Mac 上 Python 環(huán)境管理的方方面面，希望能幫助你建立清晰的認知，避免踩坑。文末會詳細說明開頭這個問題的完整排查和解決過程。

一、Mac 系統(tǒng)自帶的 Python

歷史背景與現(xiàn)狀

早期的 macOS（10.15 Catalina 及之前）會預(yù)裝 Python 2.7，路徑通常在 /usr/bin/python。這是因為 macOS 的一些系統(tǒng)工具和腳本依賴 Python 運行。

從 macOS 12.3 開始，Apple 移除了預(yù)裝的 Python 2.7?，F(xiàn)在的 macOS 只保留了一個「橋接」機制：當你在終端輸入 python3 時，如果系統(tǒng)檢測到?jīng)]有安裝 Python，會提示你安裝 Xcode Command Line Tools，安裝后會得到一個位于 /usr/bin/python3 的 Python。

# 查看系統(tǒng) Python
/usr/bin/python3 --version
# Python 3.9.6 (取決于你的 macOS 版本)

為什么不推薦用于開發(fā)

系統(tǒng)自帶的 Python 存在幾個問題：

1. 版本滯后：系統(tǒng) Python 的版本由 Apple 控制，通常比較老舊，且不會頻繁更新
2. 權(quán)限受限：安裝第三方包時可能遇到權(quán)限問題，需要 sudo，這不是好習(xí)慣
3. 可能影響系統(tǒng)：雖然現(xiàn)代 macOS 的系統(tǒng) Python 相對獨立，但在系統(tǒng)級目錄安裝包仍有風(fēng)險
4. 不可控：macOS 升級時可能會重置或修改系統(tǒng) Python 環(huán)境

什么時候可以用

說實話，幾乎沒有場景需要直接使用系統(tǒng) Python 進行開發(fā)。它存在的意義更多是為了系統(tǒng)兼容性。唯一的例外可能是運行一些簡單的一次性腳本，且你不想安裝任何額外工具。

二、Conda（Anaconda / Miniconda）中的 Python

Conda 是什么

Conda 是一個跨平臺的包管理器和環(huán)境管理器，最初由 Anaconda 公司開發(fā)，主要面向數(shù)據(jù)科學(xué)和科學(xué)計算領(lǐng)域。它有兩個發(fā)行版：

Miniconda 安裝教程（推薦）

對于大多數(shù)用戶，我推薦安裝 Miniconda——輕量、靈活，需要什么裝什么。

第一步：下載安裝包

訪問 Miniconda 官網(wǎng)下載頁面：https://docs.conda.io/en/latest/miniconda.html

或者直接用命令行下載（推薦）：

# Apple Silicon Mac (M1/M2/M3/M4)
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh

# Intel Mac
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh

?? 如何判斷你的 Mac 是哪種芯片？
點擊左上角 → 「關(guān)于本機」，查看「芯片」或「處理器」信息。

第二步：運行安裝腳本

# Apple Silicon Mac
bash Miniconda3-latest-MacOSX-arm64.sh

# Intel Mac
bash Miniconda3-latest-MacOSX-x86_64.sh

安裝過程中會有幾個提示：

1. 閱讀許可協(xié)議：按 Enter 翻頁，輸入 yes 同意
2. 安裝位置：默認是 /opt/anaconda3 或 ~/miniconda3，直接按 Enter 使用默認值即可
3. 初始化 Conda：輸入 yes，這會自動配置你的 shell

第三步：重啟終端并驗證

關(guān)閉當前終端，重新打開一個新終端：

# 驗證安裝
conda --version
# conda 24.x.x

# 查看 Python 路徑
which python
# /opt/anaconda3/bin/python

python --version
# Python 3.12.x

如果看到類似輸出，說明安裝成功！

第四步：配置國內(nèi)鏡像（可選但推薦）

國內(nèi)用戶建議配置清華鏡像源，加速包下載：

# 配置 conda 鏡像
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --set show_channel_urls yes

# 配置 pip 鏡像
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

Conda Python 的安裝路徑

安裝完成后，Conda 相關(guān)文件的位置：

# Conda 主目錄（base 環(huán)境）
/opt/anaconda3/
├── bin/
│   ├── python          # base 環(huán)境的 Python
│   ├── python3         # 同上
│   ├── pip
│   └── conda
├── envs/               # 所有虛擬環(huán)境都在這里
│   ├── myproject/      # 環(huán)境: myproject
│   └── chatgpt-on-wechat/  # 環(huán)境: chatgpt-on-wechat
└── ...

# 查看實際路徑
which python
# /opt/anaconda3/bin/python  (base 環(huán)境)

conda activate myproject
which python
# /opt/anaconda3/envs/myproject/bin/python  (myproject 環(huán)境)

Conda 基本使用

# 創(chuàng)建新環(huán)境（指定 Python 版本）
conda create -n myproject python=3.11

# 查看所有環(huán)境
conda env list

# 激活環(huán)境
conda activate myproject

# 退出當前環(huán)境
conda deactivate

# 刪除環(huán)境
conda env remove -n myproject

# 在環(huán)境中安裝包
conda activate myproject
conda install numpy pandas jupyter

# 導(dǎo)出環(huán)境配置（便于分享）
conda env export > environment.yml

# 從配置文件創(chuàng)建環(huán)境
conda env create -f environment.yml

Conda 環(huán)境的優(yōu)勢

1. 依賴隔離：每個環(huán)境有獨立的包，不會相互污染
2. 版本自由：可以為不同項目創(chuàng)建不同 Python 版本的環(huán)境
3. 跨語言支持：Conda 不只管理 Python，還能管理 R、Node.js 等
4. 二進制包：Conda 的包是預(yù)編譯的，安裝 NumPy、TensorFlow 等通常比 pip 更順暢

適合使用 Conda 的場景

• 數(shù)據(jù)科學(xué)、機器學(xué)習(xí)項目
• 需要使用多個 Python 版本的場景
• 項目依賴復(fù)雜的 C/C++ 編譯庫（如 OpenCV、PyTorch）
• 科研工作，需要復(fù)現(xiàn)他人環(huán)境

三、Homebrew 安裝的 Python

Homebrew 的定位

Homebrew 是 macOS 上最流行的包管理器，被稱為「macOS 缺失的包管理器」。它主要用于安裝各種命令行工具和開發(fā)依賴。

安裝 Homebrew（如果還沒有）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝后根據(jù)提示配置 PATH。

通過 Homebrew 安裝 Python

# 安裝最新版 Python
brew install python

# 或安裝指定版本
brew install python@3.11
brew install python@3.12

Homebrew Python 的路徑

# Apple Silicon Mac
/opt/homebrew/bin/python3
/opt/homebrew/bin/pip3

# Intel Mac  
/usr/local/bin/python3
/usr/local/bin/pip3

Homebrew Python 的特點

1. 版本較新：Homebrew 會及時更新 Python 版本
2. 與系統(tǒng)隔離：不會影響系統(tǒng) Python
3. 沒有環(huán)境管理：Homebrew 本身不提供虛擬環(huán)境功能，需要配合 venv 使用
4. 可能被其他工具依賴：一些 Homebrew 安裝的工具會依賴 Homebrew Python

配合 venv 使用

# 創(chuàng)建虛擬環(huán)境
python3 -m venv .venv

# 激活
source .venv/bin/activate

# 安裝依賴
pip install -r requirements.txt

# 退出
deactivate

適合使用 Homebrew Python 的場景

• 輕量級開發(fā)，不想安裝 Anaconda
• 開發(fā)命令行工具
• 已經(jīng)重度使用 Homebrew 生態(tài)的用戶
• 配合 venv 進行簡單的項目隔離

四、多 Python 共存時的使用策略

理解它們的關(guān)系

在一臺 Mac 上，完全可能同時存在這三種 Python：

# 系統(tǒng) Python
/usr/bin/python3

# Homebrew Python
/opt/homebrew/bin/python3

# Conda Python（base 環(huán)境）
/opt/anaconda3/bin/python

# Conda Python（某個具體環(huán)境）
/opt/anaconda3/envs/myenv/bin/python

它們是完全獨立的 Python 安裝，有各自的包目錄、各自的 pip。

關(guān)鍵在于：當你執(zhí)行 python 或 python3 時，系統(tǒng)通過 PATH 環(huán)境變量決定使用哪一個。PATH 中排在前面的目錄會被優(yōu)先搜索。

如何判斷當前使用的是哪個 Python

# 查看 python3 的路徑
which python3

# 查看 python 的路徑  
which python

# 查看 Python 版本和詳細路徑
python3 -c "import sys; print(sys.executable)"

# 查看 PATH 中所有的 python3
type -a python3

# 查看 PATH 順序
echo $PATH | tr ':' '\n'

不同項目應(yīng)如何選擇

五、python和python3的區(qū)別與使用建議

歷史背景

這要從 Python 2 和 Python 3 的分裂說起。Python 3 在 2008 年發(fā)布，與 Python 2 不完全兼容。為了讓兩個版本共存，社區(qū)約定：

• python → Python 2
• python3 → Python 3

這個約定延續(xù)至今，盡管 Python 2 已經(jīng)在 2020 年停止維護。

在 Mac 上的現(xiàn)狀

現(xiàn)在的 macOS 上：

• /usr/bin/python 已經(jīng)不存在（或指向 python3）
• /usr/bin/python3 指向系統(tǒng) Python 3
• Homebrew 只提供 python3，但會創(chuàng)建 python 軟鏈接
• Conda 環(huán)境中，python 和 python3 都指向同一個解釋器

但問題在于：如果你的 PATH 配置不當（就像我開頭遇到的問題），python 和 python3 可能指向不同的解釋器。

建議

1. 日常開發(fā)中，建議統(tǒng)一使用 python（確保在正確的虛擬環(huán)境中）
2. 寫腳本的 shebang 時，使用 #!/usr/bin/env python3，這樣會使用 PATH 中的 python3
3. 遇到不確定時，先用 which python 和 which python3 確認路徑

六、pip和pip3的區(qū)別與正確用法

基本對應(yīng)關(guān)系

理論上：

• pip 對應(yīng) python
• pip3 對應(yīng) python3

但實際情況復(fù)雜得多。在不同環(huán)境下，它們可能指向不同的位置，也可能指向同一個。

常見誤區(qū)

最常見的錯誤是：在虛擬環(huán)境中使用了全局的 pip。

# 你以為安裝到了 Conda 環(huán)境
pip install requests

# 但實際上可能安裝到了系統(tǒng) Python
which pip
# /usr/bin/pip3  ← 錯誤！

最佳實踐：使用python -m pip

為了避免混淆，強烈建議使用這種方式安裝包：

# 確保使用當前 Python 對應(yīng)的 pip
python -m pip install requests

# 或者在 Conda 環(huán)境中
conda activate myenv
python -m pip install requests

python -m pip 的含義是：使用當前 python 命令對應(yīng)的解釋器來運行 pip 模塊。這樣就不會出現(xiàn)「pip 和 python 對應(yīng)不上」的問題。

在 Conda 環(huán)境中

Conda 有自己的包管理命令：

# 推薦：使用 conda 安裝
conda install numpy

# 也可以用 pip（在 Conda 環(huán)境中）
python -m pip install some-package

一般建議：能用 conda install 的就用 Conda，只有 Conda 沒有的包才用 pip。

七、項目級 Python 環(huán)境管理最佳實踐

為什么每個項目都應(yīng)該有獨立環(huán)境

這是 Python 開發(fā)的黃金法則：永遠不要在全局環(huán)境中開發(fā)項目。

原因很簡單：

• 項目 A 需要 requests==2.25.0
• 項目 B 需要 requests==2.31.0
• 全局安裝只能有一個版本，必然沖突

Conda env vs venv 的選擇

標準工作流程示例

使用 Conda：

# 創(chuàng)建環(huán)境
conda create -n myproject python=3.11

# 激活環(huán)境
conda activate myproject

# 安裝依賴
conda install numpy pandas
python -m pip install some-other-package

# 導(dǎo)出環(huán)境（便于他人復(fù)現(xiàn)）
conda env export > environment.yml

# 從文件創(chuàng)建環(huán)境
conda env create -f environment.yml

使用 venv：

# 創(chuàng)建環(huán)境（在項目目錄下）
python3 -m venv .venv

# 激活環(huán)境
source .venv/bin/activate

# 安裝依賴
python -m pip install -r requirements.txt

# 導(dǎo)出依賴
python -m pip freeze > requirements.txt

Mac 新手的環(huán)境管理「避坑清單」

1. 不要用 sudo pip install：這會把包裝到系統(tǒng)目錄，造成混亂
2. 不要在 base 環(huán)境工作：Conda 的 base 環(huán)境應(yīng)該保持干凈
3. 激活環(huán)境后再裝包：確認 which python 指向正確路徑
4. 項目目錄下保留環(huán)境配置文件：requirements.txt 或 environment.yml
5. 定期清理不用的環(huán)境：conda env list 查看，conda env remove -n name 刪除

八、常見問題排查

問題：python和python3指向不同路徑（本文開頭的問題）

這是我在整理環(huán)境時遇到的真實問題，這里詳細記錄排查和解決過程。

問題現(xiàn)象

激活 Conda 環(huán)境后，python 和 python3 指向不同的解釋器：

(chatgpt-on-wechat) cong@MacBook-Pro % which python
/opt/anaconda3/envs/chatgpt-on-wechat/bin/python  ← 正確

(chatgpt-on-wechat) cong@MacBook-Pro % which python3  
/usr/bin/python3  ← 錯誤！應(yīng)該也指向 conda 環(huán)境

排查步驟

第一步：檢查 Conda 環(huán)境中是否有 python3

ls -la /opt/anaconda3/envs/chatgpt-on-wechat/bin/python*

輸出顯示 python3 軟鏈接是存在的：

lrwxr-xr-x  python -> python3.9
lrwxr-xr-x  python3 -> python3.9
-rwxr-xr-x  python3.9

第二步：檢查 PATH 順序

echo $PATH | tr ':' '\n' | head -20

發(fā)現(xiàn)問題：Conda 環(huán)境路徑排在 /usr/bin 后面：

/Users/cong/go/bin
/opt/homebrew/bin
...
/usr/bin              ← 第9位
...
/opt/anaconda3/envs/chatgpt-on-wechat/bin  ← 第18位，太靠后了！

第三步：檢查 shell 配置文件

cat ~/.zshrc
cat ~/.zprofile

發(fā)現(xiàn) ~/.zprofile 中有：

eval $(/opt/homebrew/bin/brew shellenv)

/etc/zprofile 中有：

if [ -x /usr/libexec/path_helper ]; then
    eval `/usr/libexec/path_helper -s`
fi

問題根因

macOS 的 shell 配置文件加載順序是：

/etc/zprofile → ~/.zprofile → ~/.zshrc

1. /etc/zprofile 中的 path_helper 會把系統(tǒng)路徑（如 /usr/bin）放到前面
2. ~/.zprofile 中的 brew shellenv 也會修改 PATH
3. ~/.zshrc 中如果有 typeset -U path（zsh 的路徑去重），會阻止 Conda 把環(huán)境路徑移到最前面

關(guān)鍵點：typeset -U path 的作用是去重，但副作用是——當 Conda 嘗試把環(huán)境路徑加到 PATH 最前面時，如果這個路徑已存在，它不會被移動，而是保持原位。

解決方案

在 ~/.zshrc 的 Conda 初始化之后，添加一段代碼強制將 Conda 環(huán)境路徑放到最前面。

最終的 ~/.zshrc 配置：

# --- 1. 基礎(chǔ)設(shè)置 ---
# 注意：typeset -U path 放到文件最后，避免影響 Conda 路徑優(yōu)先級

# --- 2. 導(dǎo)出必要的環(huán)境變量 (不涉及 PATH) ---
export GOPATH=$HOME/go
export GOROOT="/opt/homebrew/opt/go/libexec"
export GOPROXY=https://goproxy.cn,direct

# --- 3. 手動管理路徑優(yōu)先級 ---
# 我們把系統(tǒng)路徑 $path 放在最后，確保我們安裝的工具優(yōu)先
path=(
    $GOPATH/bin
    $GOROOT/bin
    /opt/homebrew/bin
    /opt/homebrew/sbin
    /usr/local/bin
    $path
)
export PATH

# --- 4. Conda 初始化 ---
# >>> conda initialize >>>
__conda_setup="$('/opt/anaconda3/bin/conda' 'shell.zsh' 'hook' 2> /dev/null)"
if [ $? -eq 0 ]; then
    eval "$__conda_setup"
else
    if [ -f "/opt/anaconda3/etc/profile.d/conda.sh" ]; then
        . "/opt/anaconda3/etc/profile.d/conda.sh"
    else
        export PATH="/opt/anaconda3/bin:$PATH"
    fi
fi
unset __conda_setup
# <<< conda initialize <

# --- 5. 修復(fù) Conda 環(huán)境 PATH 優(yōu)先級 ---
# 確保激活的 Conda 環(huán)境路徑始終在最前面
if [[ -n "$CONDA_PREFIX" ]]; then
    export PATH="$CONDA_PREFIX/bin:$PATH"
fi

# --- 6. 路徑去重（放在最后）---
typeset -U path

驗證修復(fù)

# 重新加載配置
source ~/.zshrc

# 重新激活環(huán)境并驗證
conda deactivate && conda activate chatgpt-on-wechat

# 檢查結(jié)果
which python
# /opt/anaconda3/envs/chatgpt-on-wechat/bin/python ?

which python3
# /opt/anaconda3/envs/chatgpt-on-wechat/bin/python3 ?

配置要點總結(jié)

問題：pip install后找不到包

# 檢查 pip 對應(yīng)的 Python
pip --version
# pip 24.0 from /opt/anaconda3/lib/python3.12/site-packages/pip (python 3.12)

# 檢查當前 Python
which python

# 如果不一致，使用 python -m pip
python -m pip install package-name

問題：Conda 命令找不到

重新初始化 Conda：

# 手動初始化
/opt/anaconda3/bin/conda init zsh

# 重啟終端
source ~/.zshrc

九、總結(jié)與推薦方案

三種 Python 對比

決策指南

給不同用戶的建議

入門學(xué)習(xí)者：

• 安裝 Miniconda
• 為每個學(xué)習(xí)項目創(chuàng)建獨立環(huán)境
• 用 python（不是 python3）和 python -m pip

數(shù)據(jù)科學(xué)從業(yè)者：

• 使用 Conda 管理環(huán)境
• 優(yōu)先用 conda install，其次 pip
• 善用 environment.yml 分享環(huán)境配置

Web / 后端開發(fā)者：

• Homebrew Python + venv 足夠用
• 項目根目錄放 .venv/ 和 requirements.txt
• CI/CD 中用 python -m pip install -r requirements.txt

結(jié)語

Python 環(huán)境管理看似繁瑣，但只要理解了底層邏輯，建立起清晰的認知框架，就能游刃有余。

核心原則就三條：

1. 不要用系統(tǒng) Python 開發(fā)
2. 每個項目用獨立環(huán)境
3. 安裝包前確認當前環(huán)境

希望這篇文章能幫助你在 Python 環(huán)境管理這件事上少走彎路！

到此這篇關(guān)于Mac電腦中Python環(huán)境的管理與實踐的文章就介紹到這了,更多相關(guān)Mac中Python環(huán)境管理實踐內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論