如何规范管理Python环境？清理旧环境并设置全局Python 3.12.2

macOS #

• 先列出所有已安装的Python版本，终端执行：ls /usr/local/bin/python* 或 which -a python
• 删除python.org手动安装的旧版本：
  • 删除框架文件：sudo rm -rf /Library/Frameworks/Python.framework/Versions/[旧版本号]（将[旧版本号]替换为3.10、3.11这类具体版本）
  • 删除对应的命令链接：sudo rm /usr/local/bin/python[旧版本号]，以及对应pip链接sudo rm /usr/local/bin/pip[旧版本号]
• 注意：系统自带的Python（路径通常为/usr/bin/python）不要删除，避免破坏系统组件

Windows #

• 打开「设置」→「应用」→「应用和功能」，找到所有旧版Python（如Python 3.10.x），点击卸载
• 手动删除残留文件：前往C:\Users\你的用户名\AppData\Local\Programs\Python文件夹，删除旧版本对应的目录
• 清理环境变量：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在系统变量的Path列表中删除旧Python的路径

macOS #

• 先确认3.12.2的安装路径：终端执行which python3.12，得到类似/usr/local/bin/python3.12的路径
• 替换全局Python链接：
  • 先删除现有可能的链接：sudo rm /usr/local/bin/python sudo rm /usr/local/bin/python3
  • 新建软链接指向3.12.2：sudo ln -s /usr/local/bin/python3.12 /usr/local/bin/python，同理执行sudo ln -s /usr/local/bin/pip3.12 /usr/local/bin/pip
• 验证：终端输入python --version和pip --version，显示3.12.2即设置成功

Windows #

• 找到3.12.2的安装目录，例如C:\Users\你的用户名\AppData\Local\Programs\Python\Python312
• 调整环境变量优先级：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，将Python312的路径（含其下的Scripts文件夹）移到Path列表最顶部
• 验证：命令行输入python --version和pip --version，确认显示3.12.2

VS Code配置 #

• 打开VS Code，按下Ctrl+Shift+P（macOS为Cmd+Shift+P），搜索「Python: Select Interpreter」，选择已设置的全局Python 3.12.2
• 设置为默认环境：按下Ctrl+,打开用户设置，搜索「python.defaultInterpreterPath」，将值改为全局Python的路径（如macOS的/usr/local/bin/python，Windows的C:\...\Python312\python.exe）

macOS（用Homebrew） #

• 未安装Homebrew的话按官方步骤完成安装，之后用它管理Python：
  • 安装3.12系列：brew install python@3.12
  • 升级同系列小版本：brew update && brew upgrade python@3.12
  • 升级到大版本（如3.13）：执行brew install python@3.13，再重复前面设置软链接的步骤，将全局指向新版本即可
• Homebrew会自动维护命令链接，无需手动修改

Windows（用winget） #

• Windows 10 1709以上版本自带winget，未安装的话去微软商店安装App Installer
• 安装3.12：winget install Python.Python.3.12
• 升级同系列小版本：winget upgrade Python.Python.3.12
• 升级到大版本（如3.13）：执行winget install Python.Python.3.13，再将新版本路径移到环境变量Path最顶部，设为全局默认

内容的提问来源于stack exchange，提问作者riddhimanrana