结论是：which -a python3 多输出或能执行已删版本命令，说明残留未清；必须逐个清理 /library/frameworks/、/usr/local/bin/、~/.pyenv/ 及 shell 配置中的路径和链接，严禁动 macos 系统自带 python。
直接说结论：which -a python3 还有多个输出，就说明没卸干净；只要终端里还能执行 python3.11 或 pip3.12，哪怕它报错“command not found”或“No module named pip”，也代表残留路径或软链接还在——必须逐个击破。
先确认哪些 Python 是你装的，哪些是系统命脉
macOS 系统自带的 /usr/bin/python3（Monterey 后版本）和 /System/Library/Frameworks/Python.framework 下所有内容，绝对不能动。它们被系统工具深度依赖，删了可能导致软件更新失败、Xcode 命令行工具异常等隐性故障。
- 你该清理的只有三类：
/Library/Frameworks/Python.framework/Versions/下的版本目录、/usr/local/bin/下的符号链接、以及~/.pyenv/或brew管理的安装体 - 运行
which -a python python3 python3.9 python3.11 python3.12，把所有输出路径记下来 - 对每个路径执行
ls -l，看它是否真实指向一个存在的二进制文件；若指向已删除目录（比如/Library/Frameworks/Python.framework/Versions/3.11/bin/python3但该目录不存在），就是失效软链接，得删 - 用
brew list | grep python查 Homebrew 安装的包名，常见如python@3.9、python@3.11、pyenv——brew uninstall python默认只卸最新版，不连带其他，必须显式列出
Homebrew 安装的 Python 版本要逐个卸载+清链+清缓存
Homebrew 的 Python 不是“卸一个就全清”，每个 python@3.x 是独立包，卸载后还会留 /usr/local/bin/ 下的链接和用户级 site-packages 缓存。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 先查全量：
brew list | grep python - 逐个卸载：
brew uninstall python@3.9 python@3.11 python@3.12 - 删掉对应链接：
rm -f /usr/local/bin/python3.9 /usr/local/bin/pip3.9 /usr/local/bin/pyvenv3.9 - 清理无用缓存：
brew cleanup && brew prune，再手动删~/Library/Caches/Homebrew/python@3.*_*（如有） - 检查残留链接：
ls -l /usr/local/bin | grep python，对指向已删版本的链接补删
官网 .pkg 安装的 Python 必须三处同步清除
从 python.org 下载安装包装的 Python，会在系统埋三个位置：框架本体、GUI 应用、/usr/local/bin/ 符号链接。漏一处，python3.11 就还在终端里活着。
- 删框架：
sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.11 - 删应用：
sudo rm -rf "/Applications/Python 3.11" - 删链接：
cd /usr/local/bin && ls -l | grep '3.11' | awk '{print $9}' | xargs -r sudo rm -f - 顺手清通用名链接：
rm -f /usr/local/bin/python3 /usr/local/bin/pip3 /usr/local/bin/pyvenv /usr/local/bin/idle3（它们常指向已删框架，导致后续命令报错）
PATH 和 shell 配置里的残留最容易被忽略
就算所有二进制和链接都删光了，如果 ~/.zshrc 或 ~/.bash_profile 里还写着 export PATH="/Library/Frameworks/Python.framework/Versions/3.11/bin:$PATH"，终端一启动就会把那个已失效路径加进去，which python3 还会显示它——只是执行时报错。
- 搜索配置文件：
grep -n "Python\|python3\|/usr/local/bin" ~/.zshrc ~/.bash_profile ~/.profile 2>/dev/null - 删掉所有含
/Library/Frameworks、/usr/local/bin、~/.pyenv的PATH追加行 - 重载配置：
source ~/.zshrc（或对应 shell 文件） - 验证：
echo $PATH看是否还有可疑路径；which -a python3应只返回/usr/bin/python3
真正麻烦的不是删文件，而是那些指向空目录的软链接、藏在 shell 配置里的 PATH 行、以及 Homebrew 卸载时默认不处理旧版本的惯性逻辑——这些地方不动手细查，重装新 Python 后依然会调用错 pip、venv 创建失败、甚至 python3 --version 显示的还是旧版本号。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
