Python 3.9 安装

Python 3.9 安装全攻略|零基础快速上手指南

Python 3.9 是 Python 编程语言的重要版本之一,于 2020 年 10 月 5 日正式发布,带来了多项语言特性增强、性能优化与标准库更新。作为当前广泛应用于 Web 开发、数据科学、自动化运维、人工智能等领域的主流版本,其安装与配置是开发者踏上 Python 之旅的第一步。本指南将系统介绍 Python 3.9 安装 的全流程,覆盖 Windows、macOS、Linux(Ubuntu/CentOS/Fedora)三大平台,详细说明下载路径、安装步骤、环境变量配置、常见问题解决方案,并延伸至虚拟环境管理、包管理工具、IDE 推荐等周边内容,确保用户一次性完成稳定、可维护的开发环境部署。

与 Python 3.8 相比,3.9 引入了新的语法特性(如字典合并运算符 |)、更严格的类型提示支持、更高效的字符串处理方法(如 removeprefix() 和 removesuffix()),并移除了部分已弃用模块(如 distutils 的部分功能被迁移至 setuptools)。这些改进显著提升了代码可读性与开发效率。同时,CPython 解释器在 3.9 中进一步优化了内存管理与垃圾回收机制,平均性能提升约 5%~12%(依据具体场景浮动),尤其在字符串操作与字典遍历中表现突出。对于初学者而言,3.9 的错误提示更友好,文档更完善;对于资深开发者,其新特性为构建健壮系统提供了更强支撑。

值得注意的是,Python 3.9 已进入维护阶段(Maintenance Phase),官方仅提供安全补丁更新(最高支持至 2025 年 10 月)。因此,新项目建议直接采用 3.9(或更高如 3.10/3.11),但需注意部分第三方库(如旧版 Django、NumPy)可能要求 Python ≥3.9 的最低版本。本页所有内容均基于 Python 3.9 安装 实际操作经验整理,包含真实用户高频问题与解决方案,拒绝空洞理论,力求每一步可执行、可复现、可调试。

全文共计约 3,200 字,涵盖:官网下载指引、安装过程截图式说明、环境变量深度解析、常见报错代码逐行诊断、虚拟环境搭建对比、PyPI 包管理实战、主流 IDE 配置建议、以及“网友最常搜索的 10 个问题”专项解答,助您高效完成环境部署,避免踩坑。

一、全平台 Python 3.9 安装步骤详解

1. Windows 平台安装(推荐官方安装包)

打开官网 https://www.python.org/downloads/release/python-3913/(最新小版本为 3.9.13),向下滚动至「Files」区域,选择 Windows installer (64-bit)(若为 32 位系统则选 32-bit)。点击下载后双击运行安装程序。

关键步骤:

若未勾选 PATH,需手动添加:

系统属性 → 高级 → 环境变量 → 用户变量 Path → 新建 → 添加:
C:\Python39\;C:\Python39\Scripts\

⚠️ 注意:Windows 10/11 默认可能启用「应用执行别名」(App Execution Aliases),会拦截 python.exe。请进入「设置 → 应用 → 应用和功能 → Microsoft Store 应用 → Python Launcher」中关闭所有开关,或通过命令 py --version 启动 Python Launcher。

2. macOS 平台安装(Homebrew 或官方 pkg)

方案一:官方 pkg 安装包
同理下载 macOS 64-bit universal2 installer,双击运行,按向导安装(默认路径 /Library/Frameworks/Python.framework/Versions/3.9)。安装完成后,终端输入 python3 --version 应输出 Python 3.9.13。pip 已自动关联至 pip3。

方案二:Homebrew 安装(推荐高级用户)
先安装 Homebrew(若未安装):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
再执行:
brew install python@3.9
安装后路径通常为 /opt/homebrew/bin/python3.9,需确保 /opt/homebrew/bin 在 PATH 中。可通过 echo $PATH 验证,否则添加:
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

安装后验证:
python3.9 --version → Python 3.9.13
pip3 --version → pip 21.3.1 from /opt/homebrew/lib/python3.9/site-packages/pip (python 3.9)

3. Linux 平台安装(Ubuntu/CentOS/Fedora)

Ubuntu/Debian 系列:
sudo apt update && sudo apt install python3.9 python3.9-venv python3.9-dev python3-pip -y
验证:
python3.9 --version → Python 3.9.13
pip3 --version

CentOS/RHEL 系列(需启用 EPEL):
sudo yum install epel-release -y && sudo yum install python39 python39-devel python3-pip -y
验证:
python3.9 --version

Fedora:
sudo dnf install python3.9 python3-pip -y

⚠️ Linux 系统通常自带 Python 2 或旧版 Python 3(如 3.6),切勿删除系统自带 Python!避免破坏系统工具(如 yum、gedit)。建议通过 python3.9 显式调用,或配置别名:
echo 'alias python=python3.9' >> ~/.bashrc && source ~/.bashrc

4. 验证安装是否成功的核心检查项

无论哪个平台,必须完成以下三项验证:

  1. python --version 或 python3 --version 显示 3.9.x;
  2. pip --version 显示 pip 21.3+;
  3. 执行简单脚本:
    python -c "import sys; print(sys.version); print(sys.executable)"
    应输出版本号及解释器路径(如 /usr/local/bin/python3.9)。

二、环境变量与路径配置深度解析

1. 为何需要配置环境变量?
环境变量 PATH 告诉操作系统在哪些目录中查找可执行文件。若未将 Python 安装路径加入 PATH,系统将无法识别 python 命令,导致「'python' 不是内部或外部命令」错误。

2. Windows 路径详解
安装后应包含以下路径(以默认安装为例):

路径类型示例路径用途
主程序目录C:\Python39\包含 python.exe、pythonw.exe
Scripts 目录C:\Python39\Scripts\包含 pip.exe、pyinstaller.exe 等工具

配置后,命令行可直接使用 pip install requests,而非 C:\Python39\Scripts\pip install requests。

3. macOS/Linux 路径优先级原则
当存在多个 Python 版本(如 3.8、3.9、3.10),PATH 顺序决定默认版本。推荐通过 pyenv 管理版本:

brew install pyenv
pyenv install 3.9.13
pyenv global 3.9.13

验证:which python → /Users/you/.pyenv/versions/3.9.13/bin/python

4. 避免路径冲突的黄金法则

三、常见安装报错代码与解决方案(真实用户高频问题)

⚡ 错误 1:Windows 提示「无法找到 Python 模块」

现象:运行脚本时报错 No module named '_ssl' 或 ImportError: DLL load failed while importing _ssl。

原因:安装时未勾选「Install for all users」或缺少 VC++ 运行库。

解决方案:

  1. 下载并安装 Microsoft Visual C++ Redistributable (x64);
  2. 重新运行 Python 安装程序 → 选择「Modify」→ 勾选「Install for all users」、「Add Python to environment variables」、「Download debugging symbols」→ 完成安装。

⚙️ 错误 2:macOS 提示「Python 3.9 may be damaged or incomplete」

现象:安装 pkg 后打开终端,输入 python3 显示 zsh: command not found: python3。

原因:macOS 新版本(10.15+)默认使用 zsh,其配置文件为 ~/.zshrc,而安装程序仅修改了 ~/.bash_profile。

解决方案:

echo 'export PATH="/Library/Frameworks/Python.framework/Versions/3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
python3 --version

⚡ 错误 3:Linux 安装后 pip 无法使用

现象:执行 pip install numpy 报错 ModuleNotFoundError: No module named 'pip._internal.cli.main'。

原因:系统 pip 版本过旧或损坏(如 Ubuntu 20.04 默认 pip 20.0.2 与 Python 3.9 不兼容)。

解决方案:

python3.9 -m ensurepip --upgrade
python3.9 -m pip install --upgrade pip

⚠️ 错误 4:安装过程中卡在「Preparing to install」或「Extracting」

现象:Windows 安装进度条停滞 10 分钟以上。

原因:杀毒软件(如 Windows Defender、360)实时防护拦截文件写入。

解决方案:

  1. 临时关闭杀毒软件实时防护;
  2. 以管理员身份运行安装程序;
  3. 解压安装包(右键 → 解压到当前文件夹),手动运行 python-3.9.13-amd64.exe。

四、Python 3.9 生态周边:虚拟环境、包管理与 IDE 推荐

1. 虚拟环境搭建(强烈推荐!)

避免全局安装导致依赖冲突。Python 3.9 内置 venv 模块:

mkdir myproject && cd myproject
python3.9 -m venv venv
# Windows 激活
venv\Scripts\activate
# macOS/Linux 激活
source venv/bin/activate
# 验证
which python → /path/to/myproject/venv/bin/python
pip install requests

退出虚拟环境:deactivate

2. PyPI 包管理实战

常用命令速查:

操作命令
安装包pip install requests==2.28.1
卸载包pip uninstall requests
导出依赖pip freeze > requirements.txt
从文件安装pip install -r requirements.txt
升级包pip install --upgrade numpy

💡 提示:国内用户建议配置镜像源加速:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

3. 主流 IDE/编辑器推荐

〈PyCharm Community Edition〉

免费版支持核心功能:代码补全、调试、版本控制。安装后首次打开,点击「Configure → Settings → Project → Python Interpreter」,选择已创建的虚拟环境路径(如 venv/bin/python),确保自动识别 Python 3.9。

〔VS Code〕

安装扩展:Python(Microsoft 出品)和 Pylance。打开项目文件夹后,按 Ctrl+Shift+P 输入「Python: Select Interpreter」,选择 Python 3.9.x (venv) 路径。

『Jupyter Notebook』

适合数据科学与教学。安装:pip install notebook。启动后新建 Notebook,点击右上角内核(Kernel)→ Change kernel → 选择 Python 3.9(需先在虚拟环境中安装 ipykernel)。

五、Python 3.9 vs 3.10:版本选择建议

选择 Python 3.9 的理由:

选择 Python 3.10 的理由:

决策建议:

六、网友最常搜索的 10 个问题专项解答

① Python 3.9 安装后为什么没有 pip?

极少数精简版安装包(如某些 Linux 源)未包含 pip。解决方案:
python3.9 -m ensurepip --default-pip

② 如何卸载 Python 3.9 并彻底清理残留?

Windows:控制面板 → 卸载程序 → 选择 Python 3.9 → 卸载;再删除 C:\Users\用户名\AppData\Local\Programs\Python\Python39 及 AppData\Roaming\Python。
macOS:删除 /Library/Frameworks/Python.framework 和 /usr/local/bin/python3.9 等符号链接。

③ 可以同时安装 Python 3.8 和 3.9 吗?

完全可以!Windows 通过 py -3.8 和 py -3.9 切换;macOS/Linux 用 python3.8 和 python3.9 区分。避免使用 python 全局别名,改用虚拟环境隔离。

④ 安装时提示「此电脑不支持 Python 3.9」

检查系统架构:Python 3.9 要求 Windows 10+ 或 macOS 10.13+。旧系统用户可降级至 Python 3.8.10(最后支持 Windows 7 的版本)。

⑤ pip 安装包时卡在「Collecting package metadata」

网络问题!尝试:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
或配置全局镜像源(见前文)。

⑥ 如何验证安装的 Python 是否为官方版本?

运行:
python -c "import sys; print(sys.version_info); print(sys.implementation.name)"
应输出 cpython(非 PyPy)及版本号。

⑦ Python 3.9 是否支持 Windows 7?

官方已停止支持。但 Python 3.9.13 安装包仍可在 Win7 运行,需手动安装 VC++ 2015-2019 运行库。

⑧ 如何设置 Python 3.9 为系统默认 python 命令?

Windows:通过「应用执行别名」关闭 python.exe 和 py.exe 的别名;
Linux/macOS:添加别名:
echo 'alias python=python3.9' >> ~/.bashrc && source ~/.bashrc

⑨ 安装后 python 命令无反应(Windows)

可能是 PowerShell 启用了 python 作为别名。执行:
Remove-Item alias:python -Scope Global
或在 cmd 中运行 py -0p 查看所有 Python 版本路径。

⑩ 如何为 Python 3.9 安装 OpenSSL 支持(用于 HTTPS)?

Windows:重新安装 Python 并勾选「Install for all users」;
macOS:确保安装了 Xcode Command Line Tools:
xcode-select --install