Windows 10 系统 Python 3.10 详细安装与环境配置指南

五、安装 Python 详解

安装过程相对简单，但有几个关键步骤需要特别注意，以确保环境配置正确。

第一步：运行安装程序

双击下载的 python-3.10.4-amd64.exe 文件，启动安装向导。

第二步：勾选环境变量

在安装界面的底部，有一个非常关键的复选框：Add Python 3.10 to Path。

• 含义：勾选此项后，安装程序会自动将 Python 的可执行文件路径添加到系统的 PATH 环境变量中。
• 重要性：如果不勾选，你需要手动配置环境变量，否则在命令行中输入 python 将无法识别命令。
• 建议：务必勾选此项。这是最便捷的方式。

勾选后，点击 Customize installation（自定义安装）按钮。不要直接点击 Install Now，因为后者会默认安装到 C 盘。

第三步：选配安装功能

进入 Optional Features（可选功能）界面，保持默认勾选即可，主要包括：

• tcl/tk and IDLE：提供图形化界面支持。
• pip：Python 的包管理工具，必须安装。
• Documentation：官方文档。
• py launcher：Python 启动器。

点击 Next 继续。

第四步：自定义安装路径

进入 Advanced Options（高级选项）界面。这里可以修改具体的安装目录。

默认路径通常是 C:\Users\用户名\AppData\Local\Programs\Python\Python310。请点击 Browse 按钮，选择我们在第三步中规划的目录，例如：

D:\soft\python\python3.10\install

确认路径无误后，点击 Install 开始安装。

第五步：等待安装完成

安装程序会解压文件并注册组件，这需要一定时间。请耐心等待进度条加载完成。期间请勿关闭安装窗口。

第六步：完成安装

当看到 Setup was successful 提示时，表示安装已完成。点击 Close 关闭向导。此时，你可以删除本地的 .exe 安装包以节省空间。

六、验证安装

安装完成后，我们需要验证 Python 是否正常工作。

方法一：通过安装目录验证

进入安装路径 D:\soft\python\python3.10\install，可以看到 python.exe 可执行文件。双击它，通常会打开一个命令行终端窗口，显示 Python 的版本信息。输入 exit() 即可退出。

方法二：通过命令行验证（推荐）

按下键盘上的 Win + R 键，打开'运行'对话框，输入 cmd 并回车，打开命令提示符。

在命令行中输入以下命令：

python --version

或者：

python -V

如果配置正确，系统应返回类似 Python 3.10.4 的版本号。接着输入 python 并回车，即可进入 Python 交互式命令行环境。

在交互模式下，你可以尝试运行简单的 Python 代码：

print("Hello, World!")

如果屏幕输出了 Hello, World!，说明 Python 解释器已完全可用。输入 exit() 或按 Ctrl + Z 然后回车退出交互模式。

七、虚拟环境管理

在实际项目开发中，不同项目往往依赖不同版本的第三方库。为了避免库之间的冲突，强烈建议使用虚拟环境（Virtual Environment）。

创建虚拟环境

使用 Python 自带的 venv 模块即可创建。假设我们想在 D:\soft\python\python3.10\env 下为某个项目创建名为 my_project_env 的虚拟环境，可以在命令行中执行：

python -m venv D:\soft\python\python3.10\env\my_project_env

激活虚拟环境

创建成功后，需要激活该环境才能使用其中的 Python 和包。

在 Windows 系统中，激活脚本位于虚拟环境的 Scripts 目录下。执行以下命令激活：

D:\soft\python\python3.10\env\my_project_env\Scripts\activate.bat

激活成功后，命令行提示符前会出现 (my_project_env) 字样，表示当前处于该虚拟环境中。

退出虚拟环境

使用完毕后，输入以下命令退出：

deactivate

八、包管理工具 Pip 使用

Pip 是 Python 的标准包管理工具，用于安装、升级和卸载第三方库。

查看 Pip 版本

pip --version

安装第三方库

例如，安装常用的 requests 库：

pip install requests

升级 Pip 本身

建议定期更新 Pip 以获得最新功能和安全补丁：

python -m pip install --upgrade pip

导出依赖列表

为了方便团队协作或迁移环境，可以将当前环境安装的包导出为文本文件：

pip freeze > requirements.txt

从文件安装依赖

在另一台机器或新环境中，可以通过该文件一键安装所有依赖：

pip install -r requirements.txt

九、常见问题排查

在安装和使用过程中，可能会遇到一些常见问题，以下是解决方案：

1. 命令无法识别：如果在 cmd 中输入 python 提示不是内部或外部命令，请检查是否勾选了 Add Python to Path。若未勾选，需手动在系统环境变量中添加 Python 安装路径下的 Scripts 和 Lib 目录。
2. 权限拒绝：安装或运行某些命令时提示权限不足，请以管理员身份运行命令提示符（右键 cmd -> 以管理员身份运行）。
3. SSL 证书错误：在使用 pip install 下载包时如果遇到 SSL 证书验证失败，可以尝试添加 --trusted-host 参数，或使用国内镜像源加速下载。
4. 中文乱码：如果在命令行中处理中文出现乱码，可在 cmd 中执行 chcp 65001 切换编码为 UTF-8。

十、集成开发环境（IDE）推荐

虽然可以使用记事本编写 Python 代码，但为了提升效率，推荐使用专业的集成开发环境。

1. Visual Studio Code：轻量级、跨平台，配合 Python 插件功能强大，适合大多数场景。
2. PyCharm：功能全面，社区版免费，专业版收费，适合大型项目。
3. Jupyter Notebook：适合数据分析和教学演示，支持交互式代码运行。

选择合适的 IDE 能显著提升编码体验和调试效率。

十一、总结

本文详细讲解了在 Windows 10 系统上安装 Python 的全过程，从路径规划、下载安装、环境配置到虚拟环境管理和包管理工具的实践。遵循上述步骤，开发者可以构建一个干净、隔离且易于维护的开发环境。良好的环境配置习惯是高效编程的基础，希望本文能为你的 Python 学习之路提供帮助。