Mac上Python卸载不彻底时，需分五步清理：一、识别残留源（which -a、ls /Library/Frameworks等）；二、清除Homebrew残留（brew uninstall、rm软链）；三、删除官网.pkg框架及符号链接；四、清理shell配置中PATH路径；五、清空pip缓存与用户级包目录。
如果您在Mac上已卸载Python旧版本，但终端仍能调用python3命令、pip报错、或which python3仍有输出，则说明存在环境变量残留、符号链接未清除、或用户级配置未清理。以下是针对不同安装来源的多路径清理步骤：
一、识别残留Python安装源与路径
该步骤用于精准定位需清理的对象，避免误删系统自带Python 2.7（位于/System/Library/Frameworks/Python.framework/Versions/2.7），该路径绝对不可触碰。所有操作均应围绕用户自装路径展开。
1、列出全部Python可执行文件路径：which -a python python3 python3.11 python3.12
2、查看手动安装的框架版本：ls /Library/Frameworks/Python.framework/Versions/
立即学习“Python免费学习笔记（深入）”；
3、检查Homebrew管理的Python包：brew list | grep python
4、检查用户级Python包缓存位置：ls ~/Library/Python/
二、清除Homebrew安装的Python残留
Homebrew安装的Python通常以python@3.x形式存在，卸载后常遗留软链接、pip可执行文件及site-packages缓存，需手动清理。
1、显式卸载指定版本（如3.11与3.12）：brew uninstall python@3.11 python@3.12
2、执行深度清理并移除旧版缓存：brew cleanup && brew prune
3、删除残留pip与pyvenv等二进制链接：rm -f /usr/local/bin/pip3.11 /usr/local/bin/pip3.12 /usr/local/bin/pyvenv3.11
4、检查并移除失效软链接：ls -l /usr/local/bin | grep python | awk '{if ($11 !~ /System/) print $9}' | xargs -r rm -f
三、清除官网.pkg安装的Python框架与应用
官网安装包会在/Library/Frameworks/、/Applications/及/usr/local/bin三处写入内容，任一环节遗漏都会导致命令仍可执行或GUI应用残留。
1、删除对应版本框架本体（以3.12为例）：sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.12
2、删除配套GUI应用：sudo rm -rf "/Applications/Python 3.12"
3、批量清除指向该版本的所有符号链接：cd /usr/local/bin && ls -l | grep '3.12' | awk '{print $9}' | xargs -r sudo rm -f
4、清理通用名链接（如pyvenv、idle3等）：rm -f /usr/local/bin/pyvenv /usr/local/bin/idle3 /usr/local/bin/python3-config
四、清理shell环境变量与配置文件
即使Python本体已删，若PATH中仍包含已失效路径（如/Library/Frameworks/Python.framework/Versions/3.12/bin），终端启动时仍会尝试加载，引发command not found或No module named venv等错误。
1、查看当前PATH中可疑路径：echo $PATH | tr ':' '\n' | grep -E '(Python|python|local/bin)'
2、编辑shell配置文件（zsh为默认）：nano ~/.zshrc
3、查找并删除含Python版本路径的export语句，例如：export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"
4、重新加载配置：source ~/.zshrc
五、清除用户级pip缓存与配置
pip缓存与用户级配置独立于Python解释器存在，若不清除，重装后可能复用旧包索引或触发认证失败；用户级site-packages也会干扰新环境隔离性。
1、强制清空pip全局缓存：pip cache purge
2、删除用户安装的Python包目录：rm -rf ~/Library/Python/*
3、移除用户级pip配置文件（如有）：rm -f ~/.pip/pip.conf ~/.config/pip/pip.conf
4、删除pip日志与临时文件：rm -rf ~/Library/Caches/pip
