第一步:准备工作 - 下载 Python 安装包
-
访问官方网站
- 打开你的浏览器,访问 Python 官方下载页面:https://www.python.org/downloads/windows/
- 你会看到页面上方有 "Latest Python 3 Release" 的字样,并自动检测你的系统是 64 位还是 32 位。强烈建议下载最新的稳定版 (Python 3.12.x)。
-
选择安装包
- 对于绝大多数现代 Windows 10 系统,你应该下载 64-bit installer。
- 点击 "Download" 按钮,下载一个名为
python-3.xx.x-amd64.exe的文件。
第二步:安装 Python - 关键步骤!
这是最关键的一步,请务必仔细阅读。
-
运行安装程序
- 找到你刚刚下载的
.exe文件,双击运行它。 - Windows 可能会弹出“用户账户控制”,询问你是否允许此应用对你的设备进行更改,点击“是”。
- 找到你刚刚下载的
-
勾选 "Add Python to PATH"(极其重要!)
- 安装程序启动后,你会看到第一个界面。
- 请务必勾选 "Add Python to PATH" 这个选项! 这个选项会将 Python 添加到系统的环境变量中,这样你就可以在命令提示符或 PowerShell 中直接使用
python命令,而无需输入完整的文件路径。忘记勾选是新手最常遇到的问题。
-
选择 "Install Now"(推荐新手)
- 勾选 "Add Python to PATH" 后,点击 "Install Now" 按钮。
- 这会使用默认设置进行安装,包括将 Python 安装在你的用户目录下(
C:\Users\你的用户名\AppData\Local\Programs\Python\Python39),这通常需要管理员权限,但安装程序会自动处理。 - 安装过程很快,等待进度条完成即可。
-
(可选)"Customize installation"
- 如果你需要自定义安装路径(想安装在
C:\Python39以方便管理),或者想安装一些可选的组件(如 pip 的调试日志),可以点击 "Customize installation",但对于绝大多数用户来说,默认安装就足够了。
- 如果你需要自定义安装路径(想安装在
-
完成安装
- 安装成功后,会弹出一个提示框,告诉你 "Setup was successful"。
- 建议勾选 "Disable path length limit",这个选项可以解决 Windows 默认的 260 字符路径长度限制问题,避免在处理深层嵌套的文件路径时出错。
- 点击 "Close" 关闭窗口。
第三步:验证安装
我们需要确认 Python 是否已经正确安装并配置。
-
打开命令行工具
- 按
Win + R键,输入cmd,然后按回车,打开“命令提示符”。 - 或者,按
Win + X键,然后选择 "Windows PowerShell" 或 "终端"。
- 按
-
检查 Python 版本
- 在打开的命令行窗口中,输入以下命令并按回车:
python --version
或者使用:
python -V
- 如果安装成功,你会看到类似
Python 3.12.0的输出,如果提示'python' 不是内部或外部命令...,那几乎可以肯定是 忘记在第二步中勾选 "Add Python to PATH"。
- 在打开的命令行窗口中,输入以下命令并按回车:
-
检查 Python 解释器路径
- 输入以下命令:
where python
- 这会显示 Python 解释器所在的路径,你应该能看到一个类似
C:\Users\你的用户名\AppData\Local\Programs\Python\Python39\python.exe的路径。
- 输入以下命令:
-
检查 pip 是否可用
pip是 Python 的包管理工具,用于安装第三方库,输入以下命令检查其版本:pip --version
- 如果能看到版本信息,说明
pip也已经成功安装。
第四步:编写并运行第一个 Python 程序
让我们来创建一个经典的 "Hello, World!" 程序,确保一切正常工作。
-
创建 Python 文件
- 在桌面上右键,选择“新建” -> “文本文档”。
- 将文件名从
新建文本文档.txt修改为hello.py。注意:一定要把.txt改成.py,如果系统提示,确认更改文件扩展名。
-
编写代码
- 右键点击
hello.py文件,选择“编辑”或“用记事本打开”。 - 在记事本中输入以下代码:
print("Hello, World! 你好,世界!") - 保存并关闭记事本。
- 右键点击
-
运行程序
- 再次打开“命令提示符”或“PowerShell”。
- 使用
cd命令切换到你创建文件的目录,如果你的文件在桌面,输入:cd Desktop
- 输入以下命令来运行你的程序:
python hello.py
- 如果一切顺利,你会在命令行窗口中看到输出:
Hello, World! 你好,世界!
恭喜! 你已经成功在 Windows 10 上安装并配置好了 Python!
常见问题与解决方案 (FAQ)
问题1:运行 python --version 时提示 'python' 不是内部或外部命令...
- 原因:没有在安装时勾选 "Add Python to PATH"。
- 解决方案:
- 手动添加环境变量:
- 在 Windows 搜索栏中搜索“编辑系统环境变量”,并打开它。
- 在弹出的“系统属性”窗口中,点击“环境变量”按钮。
- 在“系统变量”(或“用户变量”)列表中,找到名为
Path的变量,选中它,然后点击“编辑”。 - 在“编辑环境变量”窗口中,点击“新建”,然后添加 Python 的安装路径,如果你使用了 "Install Now" 安装,路径通常是
C:\Users\你的用户名\AppData\Local\Programs\Python\Python39\(把Python39替换成你自己的版本号)。 - 再点击“新建”,添加
Scripts文件夹的路径:C:\Users\你的用户名\AppData\Local\Programs\Python\Python39\Scripts\。 - 确保所有路径都已添加,然后一路点击“确定”保存。
- 重要:保存后,关闭所有已打开的命令行窗口,然后重新打开一个新的,再尝试
python --version命令。
- 重新运行安装程序:如果你刚安装完不久,可以卸载 Python,然后重新运行安装程序,这次务必勾选 "Add Python to PATH"。
- 手动添加环境变量:
问题2:如何选择 Python 2 还是 Python 3?
- 答案:永远选择 Python 3,Python 2 已在 2025 年停止官方支持,不再有安全更新和新功能,所有的新项目、教程和库都基于 Python 3。
问题3:我应该用哪个代码编辑器?
- 记事本可以写代码,但没有语法高亮、自动补全等功能,不推荐。
- 强烈推荐使用专业的代码编辑器,它们能极大提升你的开发效率:
- Visual Studio Code (VS Code):免费、强大、插件丰富,是目前最受欢迎的 Python 编辑器。
- PyCharm:专为 Python 打造的集成开发环境,社区版免费,功能非常强大。
- Sublime Text:轻量、快速、优雅,需要安装插件来支持 Python。
希望这份详细的指南能帮助你顺利完成 Python 的安装!祝你编程愉快!
