目录
- 第一步:下载 Python 安装包
- 第二步:安装 Python (关键步骤)
- 第三步:验证安装与环境配置
- 第四步:选择并配置代码编辑器
- 第五步:编写并运行你的第一个 Python 程序
- 第六步:使用虚拟环境 (最佳实践)
- 第七步:包管理 (使用 pip)
- 常见问题与解决方案
第一步:下载 Python 安装包
- 访问官网:打开浏览器,访问 Python 官方下载页面:https://www.python.org/downloads/windows/
- 选择版本:
- 推荐新手:下载最新的 稳定版,页面通常会高亮显示 "Latest Python 3 Release",Python 3.12.x,新版本通常包含更多新特性和性能优化,并且对旧版本的 Bug 修复更及时。
- 注意:请确保下载的是 Python 3.x 版本,而不是 Python 2.x,Python 2.x 已在 2025 年停止官方支持,不建议新项目使用。
- 下载安装包:
- 你会看到两个选项:"Download x86-64 installer" 和 "Download x86 installer"。
- x86-64 installer:这是 64 位版本的安装包,如果你的电脑是近几年购买的,几乎可以肯定是 64 位系统。请优先选择这个版本。
- x86 installer:这是 32 位版本的安装包,仅用于非常老旧的电脑。
第二步:安装 Python (最关键的一步)
双击你下载的 .exe 文件,开始安装,请务必勾选以下两个选项,这能省去你后续很多麻烦。

-
勾选 "Add Python to PATH":
- 这是最重要的选项! 勾选它后,你就可以在 Windows 的命令提示符 或 PowerShell 中直接输入
python命令,而不需要每次都输入完整的安装路径,如果不勾选,系统将无法识别python命令。
- 这是最重要的选项! 勾选它后,你就可以在 Windows 的命令提示符 或 PowerShell 中直接输入
-
选择 "Install Now" (推荐新手):
这会使用默认设置进行安装,包括将 Python 安装到你的用户目录下,这通常不需要管理员权限,非常方便。
-
(可选) 选择 "Customize installation":
(图片来源网络,侵删)如果你需要安装到特定位置、修改文档关联或选择性地安装某些组件,可以点击这个选项,对于新手,默认安装即可。
-
等待安装完成:点击 "Install Now" 后,等待安装程序完成即可,完成后会显示一个 "Setup was successful" 的提示,点击 "Close" 关闭。
第三步:验证安装与环境配置
安装完成后,我们需要验证 Python 是否正确安装,并且环境变量是否配置成功。
-
打开命令行工具:
(图片来源网络,侵删)- 按
Win+S键,搜索 "cmd" 或 "PowerShell",然后打开 "命令提示符" 或 "Windows PowerShell"。
- 按
-
检查 Python 版本:
- 在打开的黑色窗口中,输入以下命令并按回车:
python --version
- 如果看到类似
Python 3.12.0的输出,恭喜你!Python 已经成功安装并且系统可以找到它。 - 如果提示
'python' 不是内部或外部命令...,说明你没有在安装时勾选 "Add Python to PATH",别担心,我们可以手动添加。
- 在打开的黑色窗口中,输入以下命令并按回车:
-
手动添加环境变量 (如果需要):
- 在 Windows 搜索栏中搜索 “编辑系统环境变量”,然后打开它。
- 在弹出的“系统属性”窗口中,点击右下角的“环境变量...”按钮。
- 在“系统变量”部分,找到名为
Path的变量,选中它,然后点击“编辑...”。 - 在“编辑环境变量”窗口中,点击“新建”,然后粘贴你的 Python 安装路径,通常是
C:\Users\<你的用户名>\AppData\Local\Programs\Python\Python3x(C:\Users\JohnDoe\AppData\Local\Programs\Python\Python312)。 - 再点击“新建”,粘贴 Python 的 Scripts 路径,通常是
C:\Users\<你的用户名>\AppData\Local\Programs\Python\Python3x\Scripts。 - 确保这两个新路径在列表的顶部,然后一路点击“确定”保存所有更改。
- 重要:关闭所有已打开的命令行窗口,然后重新打开一个新的,再次运行
python --version命令。
-
检查 pip:
pip是 Python 的包管理工具,随 Python 一起安装,在命令行中输入:pip --version
- 如果能看到版本信息,说明
pip也配置好了。
第四步:选择并配置代码编辑器
光有命令行是不够的,你需要一个专门的工具来编写和编辑 Python 代码,这里推荐两款目前最主流的工具。
推荐选项 1:Visual Studio Code (VS Code) - 强大且免费
- 下载与安装:访问 https://code.visualstudio.com/,下载并安装 Windows 版本,安装时,你可以选择默认安装,也可以勾选 "Add to PATH"。
- 安装 Python 扩展:
- 打开 VS Code。
- 点击左侧活动栏的“扩展”图标(或按
Ctrl+Shift+X)。 - 在搜索框中输入 "Python"。
- 找到由 Microsoft 发布的 Python 扩展,点击“安装”。
- 配置解释器:
- VS Code 需要知道要使用哪个 Python 环境,安装完扩展后,VS Code 通常会自动检测到你的 Python 安装。
- 你也可以手动指定:按
Ctrl+Shift+P,输入 "Python: Select Interpreter",然后选择你刚刚安装的 Python 版本。
推荐选项 2:PyCharm Community Edition - 专为 Python 设计
- 下载与安装:访问 https://www.jetbrains.com/pycharm/download/,下载免费的 "Community" 社区版。
- 安装与配置:
- 安装过程比较直观,一路点击 "Next" 即可。
- 首次启动时,PyCharm 会引导你创建一个新的项目,它会自动检测到你系统中的 Python 解释器。
第五步:编写并运行你的第一个 Python 程序
我们使用 VS Code 作为示例。
- 创建项目文件夹:在你的电脑上创建一个文件夹,
D:\MyPythonProjects。 - 在 VS Code 中打开文件夹:打开 VS Code,
文件->打开文件夹,选择你刚刚创建的MyPythonProjects文件夹。 - 创建新文件:在左侧的文件资源管理器中,点击“新建文件”按钮,命名为
hello.py。 - 编写代码:在
hello.py文件中输入以下代码:print("Hello, World! 欢迎来到 Python 世界!") - 运行代码:
- 方法一 (推荐):在代码编辑器中,点击右上角的“运行”三角形按钮(或按
Ctrl+F5)。 - 方法二:在 VS Code 中打开一个集成终端(
终端->新终端),然后输入python hello.py并按回车。
- 方法一 (推荐):在代码编辑器中,点击右上角的“运行”三角形按钮(或按
- 查看结果:在 VS Code 的终端窗口或输出窗口中,你应该能看到:
Hello, World! 欢迎来到 Python 世界!
第六步:使用虚拟环境 (最佳实践)
当你开始开发多个项目时,不同项目可能需要不同版本的库(依赖包),虚拟环境可以为每个项目创建一个独立的、干净的 Python 环境,避免版本冲突。
-
在项目文件夹中创建虚拟环境:
- 在 VS Code 中打开你的项目文件夹(如
MyPythonProjects)。 - 打开终端(
终端->新终端)。 - 在终端中输入以下命令并按回车:
# myenv 是虚拟环境的名字,你可以自定义 python -m venv myenv
- 这时,你的项目文件夹下会多出一个名为
myenv的文件夹。
- 在 VS Code 中打开你的项目文件夹(如
-
激活虚拟环境:
- 在命令提示符 中:
myenv\Scripts\activate.bat
- 在 PowerShell 中 (如果策略不允许,可能需要先执行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process):.\myenv\Scripts\Activate.ps1
- 激活成功后,你的终端提示符前面会出现
(myenv),这表示你当前正在虚拟环境中工作。
- 在命令提示符 中:
-
在虚拟环境中工作:
- 现在当你使用
pip安装的任何包,都只会安装在myenv环境中,不会影响你的全局 Python 环境。 - 当你完成工作后,可以通过输入
deactivate命令来退出虚拟环境。
- 现在当你使用
第七步:包管理 (使用 pip)
pip 是用来安装和管理第三方库的工具。
-
安装包:
- 基本语法:
pip install <包名> - 安装一个非常流行的数据处理库
pandas:pip install pandas
- 最佳实践:始终在虚拟环境中安装包。
- 基本语法:
-
卸载包:
pip uninstall <包名>
-
查看已安装的包:
pip list
-
导出和安装依赖列表 (项目协作必备):
- 当你完成项目开发后,可以将所有依赖包的列表导出到一个文件中,方便他人或未来的你快速重建环境。
- 导出:
pip freeze > requirements.txt
这会生成一个
requirements.txt文件,里面列出了所有已安装的包及其版本。 - 安装:
pip install -r requirements.txt
这会读取
requirements.txt文件并安装其中列出的所有包。
第八步:常见问题与解决方案
-
问题:
pip命令执行很慢,或者提示连接超时。- 原因:默认从国外的 PyPI 源下载,国内访问较慢。
- 解决方案:使用国内镜像源,临时使用:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package
设为默认(推荐):
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
常用的国内镜像源:清华大学、阿里云、中国科技大学。
-
问题:VS Code 无法识别 Python 解释器,或者提示 "No Python interpreter found"。
- 解决方案:
- 确保你已经安装了 Python 并勾选了 "Add to PATH"。
- 确保你已经安装了 VS Code 的 Python 扩展。
- 按
Ctrl+Shift+P,输入 "Python: Select Interpreter",然后手动选择你的 Python 路径。
- 解决方案:
-
问题:运行
.py文件时,一闪而过。- 原因:程序运行完了,命令行窗口自动关闭了。
- 解决方案:
- 在代码最后添加
input()或os.system("pause")来暂停程序。 - 直接在命令行中运行
python your_script.py,这样窗口会保持打开直到你手动关闭。
- 在代码最后添加
恭喜你!按照以上步骤,你已经成功在 Windows 上搭建了一个功能完备的 Python 开发环境,现在你可以:
- 使用 Python 进行编程。
- 使用 VS Code 或 PyCharm 作为你的代码编辑器。
- 使用
pip安装和管理项目所需的库。 - 使用虚拟环境来保持项目的整洁和独立。
就可以开始你的 Python 学习和开发之旅了!祝你编码愉快!
