Mac OSX清理Python版本：仅保留可用Python3的解决方案咨询

Hey there, let's fix this messy Python environment step by step—no more conflicting versions or broken dependencies. Here's a straightforward plan to get you back on track:

Step 1: Audit Your Current Python Installations #

First, let's list all the Python versions currently on your system to know what we're dealing with:

• Run these commands to uncover all installed instances:

  which -a python3
  ls -l /usr/bin/python*
  ls -l /opt/homebrew/bin/python*  # For Apple Silicon Macs
  ls -l /usr/local/bin/python*     # For Intel Macs
  

• You’ll likely see three types of installations:
  • Mac’s system Python (in /usr/bin—leave this alone! macOS relies on it for core functions)
  • Brew-managed Python (in /opt/homebrew or /usr/local)
  • Python.org .pkg installs (stored in /Library/Frameworks/Python.framework/Versions/)

Step 2: Uninstall Unwanted Python Versions #

Remove Brew-installed extras #

1. List all Python versions managed by brew:

   brew list | grep python
   

2. Uninstall all versions except the stable release you want to keep (we recommend the latest stable version like 3.12):

   brew uninstall --force python@3.9 python@3.10  # Replace with your unwanted versions
   

3. Ensure your target version is installed (if not already):

   brew install python@3.12
   

Remove Python.org .pkg installs #

1. Delete the framework folders for unwanted versions:

   sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.9  # Match your unwanted version
   

2. Clean up leftover symlinks in /usr/local/bin:

   sudo rm /usr/local/bin/python3.9 /usr/local/bin/pip3.9  # Match the version you deleted
   

Step 3: Set Your Default Python3 #

Brew will prompt you to add its Python to your PATH after installation. If you missed that, manually update your shell config:

• For Apple Silicon (zsh is default):

  echo 'export PATH="/opt/homebrew/opt/python@3.12/libexec/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  

• For Intel Macs:

  echo 'export PATH="/usr/local/opt/python@3.12/libexec/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  

• Verify the setup works:

  python3 --version
  pip3 --version
  

Both commands should point to the same 3.12 version (or your chosen stable release).

Step 4: Install Pandas & Test Your Script #

Now that your environment is clean, install pandas properly (avoid sudo pip—it can corrupt system files):

python3 -m pip install pandas

Create a quick test script to confirm everything works:

# test_pandas.py
import pandas as pd
test_df = pd.DataFrame({"col1": [1, 2, 3], "col2": ["a", "b", "c"]})
print(test_df)

Run it with:

python3 test_pandas.py

If it prints the DataFrame without errors, you’re all set!

Pro Tip for Future Projects #

Once your base environment is stable, use virtual environments to isolate project dependencies and avoid future conflicts:

python3 -m venv my_project_env
source my_project_env/bin/activate
# Install dependencies here—they’ll only affect this project

内容的提问来源于stack exchange，提问作者Matěj M