Python 3.9.7详细安装指南与常见问题解决

# 以管理员身份运行安装程序
# 务必勾选 "Add Python 3.9 to PATH"
# 点击 "Customize installation" 进行自定义安装

python --version
# 输出：Python 3.9.7
 
pip --version
# 输出：pip 21.x.x from ...\python39\site-packages\pip (python 3.9)

# 更新 Homebrew
brew update
 
# 安装 Python 3.9.7
brew install python@3.9
 
# 链接到系统路径
echo 'export PATH="/usr/local/opt/python@3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

python3.9 --version
# 输出：Python 3.9.7

sudo apt update
sudo apt install -y software-properties-common

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update

sudo apt install python3.9 python3.9-dev python3.9-venv python3.9-distutils

# 查看当前 Python 版本
python3 --version
 
# 更新 alternatives
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.9 2
 
# 选择默认版本
sudo update-alternatives --config python3

# 创建虚拟环境
python3.9 -m venv myproject_env
 
# 激活环境
# Windows:
myproject_env\Scripts\activate
# macOS/Linux:
source myproject_env/bin/activate
 
# 验证环境
which python  # 应指向虚拟环境中的 Python

# 临时使用清华源
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name
 
# 永久配置
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 输入部分代码，TRAE IDE 会智能提示：
def calculate_fibonacci(n: int) -> int:
    """计算斐波那契数列第 n 项"""
    if n <= 1:
        return n
    # 输入 "fib" 会提示完整的递归实现
    return calculate_fibonacci(n-1) + calculate_fibonacci(n-2)

# TRAE IDE 支持条件断点
for i in range(100):
    if i == 50:  # 在此行设置条件断点 i==50
        print(f"Debug value: {i}")

# Windows 重新设置 PATH
setx PATH "%PATH%;C:\Python39;C:\Python39\Scripts"
 
# 重新打开终端验证
python --version

# 临时解决方案
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org package_name
 
# 永久解决方案（升级 pip）
python -m pip install --upgrade pip

# 使用 pyenv 管理多版本（推荐）
curl https://pyenv.run | bash
 
# 安装并设置全局版本
pyenv install 3.9.7
pyenv global 3.9.7

# Windows 以管理员身份运行 PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
 
# macOS/Linux 检查权限
chmod +x myproject_env/bin/activate

# 生产环境使用 -O 参数
python -O your_script.py

# 在项目根目录创建 .pth 文件
# 加速模块导入
import sys
sys.path.append('.')