徹底卸載macOS上所有版本Python的詳細(xì)指南

更新時(shí)間：2025年10月23日 09:44:20 作者：飛仔FeiZai

這篇文章主要為大家詳細(xì)介紹了如何徹底卸載 macOS 上所有版本的 Python,包括系統(tǒng)自帶的,Homebrew 安裝的,手動(dòng)安裝的等,下面小編就和大家簡單介紹一下吧

查看已安裝的 Python
卸載通過官方安裝包（.pkg/.dmg）安裝的 Python
卸載 Homebrew 安裝的 Python
刪除用戶環(huán)境中可能殘留的配置
檢查系統(tǒng)是否還有 Python（保留系統(tǒng)版本）
（可選）清理 PATH 環(huán)境變量
驗(yàn)證卸載結(jié)果

macOS Python 一鍵卸載腳本

使用方法

第一步：復(fù)制下面腳本到一個(gè)文件
第二步：運(yùn)行腳本
第三步：驗(yàn)證是否干凈

徹底卸載 macOS 上所有版本的 Python（包括系統(tǒng)自帶的、Homebrew 安裝的、手動(dòng)安裝的等）。

注意：macOS 自帶的 Python 2.x 或 3.x 系統(tǒng)依賴它，請(qǐng)不要?jiǎng)h除系統(tǒng)版本，否則可能導(dǎo)致 macOS 工具（如 xcode-select、brew、git）異常。

卸載 macOS 上所有版本的 Python

查看已安裝的 Python

先打開終端，執(zhí)行：

which -a python
which -a python3
ls -l /Library/Frameworks/Python.framework/Versions/
ls -l /usr/local/bin/python*

這會(huì)顯示所有 Python 路徑，比如：

/usr/bin/python3              ← 系統(tǒng)自帶（不要?jiǎng)h）
/usr/local/bin/python3.11     ← 用戶安裝的（可刪）
/Library/Frameworks/Python.framework/Versions/3.11

卸載通過官方安裝包（.pkg/.dmg）安裝的 Python

如果是從 python.org 安裝的：

執(zhí)行以下命令（以 3.11 為例）：

sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.11
sudo rm -f /Applications/Python\ 3.11
sudo rm -f /usr/local/bin/python3.11
sudo rm -f /usr/local/bin/pip3.11
sudo rm -f /usr/local/bin/idle3.11

如果有多個(gè)版本，重復(fù)執(zhí)行上面命令替換版本號(hào)（3.9、3.10、3.12 等）。

卸載 Homebrew 安裝的 Python

如果曾用 brew install python 安裝：

brew uninstall python
brew cleanup

然后確認(rèn)是否刪除干凈：

which python3
brew list | grep python

刪除用戶環(huán)境中可能殘留的配置

rm -rf ~/Library/Python
rm -rf ~/.local/lib/python*
rm -rf ~/.pyenv
rm -rf ~/.virtualenvs

如果用過 pyenv 安裝 Python：

brew uninstall pyenv
rm -rf ~/.pyenv

檢查系統(tǒng)是否還有 Python（保留系統(tǒng)版本）

python3 --version
which python3

正常情況下，系統(tǒng)還會(huì)有一個(gè) /usr/bin/python3（macOS 自帶的安全版本）。

（可選）清理 PATH 環(huán)境變量

編輯 shell 配置文件（根據(jù)用的 shell）：

Bash → ~/.bash_profile
Zsh → ~/.zshrc

刪除類似：

export PATH="/usr/local/opt/python@3.11/bin:$PATH"
export PATH="/Library/Frameworks/Python.framework/Versions/3.11/bin:$PATH"

保存后執(zhí)行：

source ~/.zshrc

驗(yàn)證卸載結(jié)果

which -a python
which -a python3

輸出應(yīng)只剩下系統(tǒng)路徑 /usr/bin/python3。

macOS Python 一鍵卸載腳本

自動(dòng)檢測(cè)并卸載所有非系統(tǒng)版本的 Python（包括官方安裝包、Homebrew、Pyenv 等）
不會(huì)刪除 macOS 自帶的系統(tǒng) Python（安全）
刪除 pip 緩存、虛擬環(huán)境和 PATH 中的無效路徑

使用方法

第一步：復(fù)制下面腳本到一個(gè)文件

在終端執(zhí)行：

nano ~/uninstall_python.sh

然后把下面內(nèi)容完整復(fù)制進(jìn)去

保存退出（Ctrl + O → 回車 → Ctrl + X）。

腳本內(nèi)容：

#!/bin/bash
echo "=============================="
echo "  ?? macOS Python 一鍵卸載腳本"
echo "=============================="
echo

# 檢查權(quán)限
if [ "$EUID" -ne 0 ]; then
  echo "??  請(qǐng)使用 sudo 運(yùn)行此腳本：sudo bash ~/uninstall_python.sh"
  exit
fi

# 卸載 Homebrew 安裝的 Python
if command -v brew &>/dev/null; then
  echo "?? 正在卸載 Homebrew Python..."
  brew uninstall --ignore-dependencies python python@3.9 python@3.10 python@3.11 python@3.12 2>/dev/null
  brew cleanup
fi

# 刪除 python.org 安裝包的 Python
echo "?? 正在刪除官方安裝包版本..."
for v in 3.9 3.10 3.11 3.12 3.13; do
  sudo rm -rf /Library/Frameworks/Python.framework/Versions/$v
  sudo rm -rf "/Applications/Python ${v}"
  sudo rm -f /usr/local/bin/python${v}
  sudo rm -f /usr/local/bin/python${v%.*}
  sudo rm -f /usr/local/bin/pip${v}
  sudo rm -f /usr/local/bin/idle${v}
done

# 刪除 pyenv
echo "?? 正在刪除 pyenv..."
brew uninstall pyenv 2>/dev/null
rm -rf ~/.pyenv

# 刪除虛擬環(huán)境和 pip 緩存
echo "?? 刪除虛擬環(huán)境和緩存..."
rm -rf ~/.local/lib/python*
rm -rf ~/Library/Python
rm -rf ~/.virtualenvs
rm -rf ~/Library/Caches/pip

# 清理 PATH 中的 Python 相關(guān)路徑
echo "?? 清理 PATH 配置..."
for f in ~/.bash_profile ~/.bashrc ~/.zshrc; do
  [ -f "$f" ] && sed -i '' '/Python.framework/d' "$f"
  [ -f "$f" ] && sed -i '' '/pyenv/d' "$f"
  [ -f "$f" ] && sed -i '' '/python@/d' "$f"
done

# 驗(yàn)證剩余版本
echo
echo "? 卸載完成！當(dāng)前系統(tǒng)保留版本："
which -a python3 || echo "未檢測(cè)到 Python"
python3 --version 2>/dev/null || echo "無系統(tǒng) Python 可用"
echo
echo "?? 如果仍檢測(cè)到非系統(tǒng)路徑，可手動(dòng)檢查："
echo "   ls -l /Library/Frameworks/Python.framework/Versions/"