从官网下载到 PyCharm 配置,一篇文章全部讲清楚
副标题:Windows 系统 Python 3.12 安装与环境配置完整教程
导语
很多初学者第一次安装 Python 时,都会遇到版本怎么选、安装选项怎么勾、命令无法识别、PyCharm 找不到解释器等问题。
这篇文章以 Windows 系统为例,从官网下载、安装、环境验证、PyCharm 配置到第三方库安装,一步一步完成 Python 开发环境搭建。
建议先收藏,再按照文章顺序操作。
━━━━━━━━━━━━━━━━━━━━
一、应该安装哪个 Python 版本?
目前更推荐安装 Python 3.12(64 位)。
选择 Python 3.12 的主要原因:
1. 版本稳定,适合日常开发和生产环境。
2. 大多数第三方库已经完成适配。
3. 可以正常使用爬虫、数据分析、Web 开发和自动化工具。
4. 相比刚发布的新版本,遇到依赖兼容问题的概率更低。
如果电脑是近十年内购买的,通常都应该选择 64 位版本。
不建议初学者为了追求“最新”,直接安装刚发布的 Python 大版本。Python 本身可能没有问题,但部分第三方库可能还没有及时适配。
━━━━━━━━━━━━━━━━━━━━
二、从 Python 官网下载安装程序
打开 Python 官方网站:
https://www.python.org/
依次进入:
Downloads → Windows
找到 Python 3.12 对应版本,下载:
Windows installer(64-bit)
注意:尽量从 Python 官网下载,不要使用来源不明的第三方安装包,避免安装到被修改过的软件。
━━━━━━━━━━━━━━━━━━━━
三、安装界面应该怎么选择?
双击安装程序后,底部通常会看到:
Add python.exe to PATH
这个选项建议勾选。它的作用是将 Python 添加到系统环境变量,方便我们在命令行中直接使用 python 命令。
接下来推荐点击:
Customize installation
而不是直接点击 Install Now。
选择自定义安装的好处是可以指定安装位置,也便于以后管理多个 Python 版本。
在 Optional Features 页面,建议保留以下选项:
1. pip
2. Python Launcher
3. Documentation
4. py launcher
进入 Advanced Options 页面后,可以勾选:
Add Python to environment variables
安装目录建议设置为简单、明确的路径,例如:
D:\Program Files\Python312
尽量避免使用中文目录或层级特别深的目录。
如果“Use admin privileges when installing py.exe”无法勾选,通常是因为安装程序没有以管理员身份运行,或者电脑中已经安装了 Python Launcher。这个选项不会影响 Python 的正常使用,可以忽略。
确认设置后,点击 Install 开始安装。
━━━━━━━━━━━━━━━━━━━━
四、验证 Python 是否安装成功
安装完成后,打开 PowerShell 或 CMD,执行:
python --version
正常情况下会显示:
Python 3.12.x
然后执行:
python -m pip --version
如果能够显示 pip 版本和安装路径,说明 Python 与 pip 都已安装成功。
还可以执行:
py -0p
该命令会列出电脑中已经安装的所有 Python 版本及对应路径。
━━━━━━━━━━━━━━━━━━━━
五、电脑中有多个 Python 版本怎么办?
一台电脑可以同时安装 Python 3.9、3.11、3.12 等多个版本,它们之间并不冲突。
通过 Python Launcher 可以指定版本运行:
py -3.12 --version
使用 Python 3.12 安装第三方库:
py -3.12 -m pip install requests
使用 Python 3.12 运行脚本:
py -3.12 test.py
这里有一个非常重要的原则:
使用哪个 Python 运行程序,就应该使用同一个 Python 安装依赖。
例如,程序使用 Python 3.12,就不要使用 Python 3.9 的 pip 安装依赖,否则很容易出现:
ModuleNotFoundError: No module named 'xxx'
━━━━━━━━━━━━━━━━━━━━
六、推荐创建独立虚拟环境
如果需要开发正式项目,建议为每个项目创建独立虚拟环境,避免不同项目的依赖互相冲突。
创建虚拟环境:
py -3.12 -m venv .venv
PowerShell 激活环境:
.\.venv\Scripts\Activate.ps1
如果系统禁止执行 PowerShell 脚本,也可以不激活,直接使用虚拟环境中的 Python:
.\.venv\Scripts\python.exe -m pip install requests
安装依赖前,建议先更新 pip:
.\.venv\Scripts\python.exe -m pip install --upgrade pip
━━━━━━━━━━━━━━━━━━━━
七、在 PyCharm 中配置 Python 解释器
打开 PyCharm,进入:
File → Settings → Project → Python Interpreter
点击添加解释器,选择:
Add Local Interpreter
如果使用系统 Python,可以选择:
D:\Program Files\Python312\python.exe
如果使用项目虚拟环境,可以选择:
项目目录\.venv\Scripts\python.exe
配置完成后,在 PyCharm Terminal 中执行:
python --version
再执行:
python -c "import sys; print(sys.executable)"
确认显示的是期望使用的 Python 版本和路径。
━━━━━━━━━━━━━━━━━━━━
八、正确安装第三方 Python 库
推荐使用下面的方式安装第三方库:
python -m pip install 库名
例如:
python -m pip install requests
安装 Redis 客户端:
python -m pip install redis
安装 Scrapling 浏览器抓取功能:
python -m pip install "scrapling[fetchers]"
Scrapling 还需要下载浏览器组件:
scrapling install
安装完成后,可以使用下面的命令验证:
python -c "from scrapling.fetchers import AsyncStealthySession; print('安装成功')"
需要特别注意:直接执行 pip install scrapling,通常只会安装核心解析功能。如果需要浏览器抓取和隐身功能,应安装 scrapling[fetchers]。
━━━━━━━━━━━━━━━━━━━━
九、常见问题解决方法
问题一:提示“python 不是内部或外部命令”
原因通常是安装时没有勾选 PATH,或者终端没有重新打开。
解决方法:
1. 关闭并重新打开 PowerShell。
2. 使用 py -3.12 代替 python。
3. 将 Python 安装目录和 Scripts 目录添加到系统 PATH。
问题二:安装了库,运行时仍然提示找不到
通常是因为安装依赖和运行程序使用了不同的 Python。
检查当前解释器:
python -c "import sys; print(sys.executable)"
检查库的安装位置:
python -m pip show 库名
问题三:pip 命令无法使用
不要直接执行 pip,可以改为:
python -m pip install 库名
问题四:PyCharm 中存在多个解释器
进入 Python Interpreter 设置页面,选择项目真正需要的版本,并在终端中通过 sys.executable 再次确认。
问题五:虚拟环境无法激活
可以直接调用虚拟环境中的 python.exe,不激活也可以正常安装依赖和运行程序。
━━━━━━━━━━━━━━━━━━━━
十、安装完成后的建议
1. 不要删除仍在使用的旧 Python 版本。
2. 每个项目尽量使用独立虚拟环境。
3. 安装依赖时尽量使用“python -m pip”。
4. 不要把密码、密钥等敏感信息直接写进代码。
5. 生产项目优先选择第三方库适配成熟的 Python 版本。
━━━━━━━━━━━━━━━━━━━━
结语
Python 安装本身并不复杂,真正容易出错的是解释器、pip 和项目环境没有对应起来。
记住下面这一句话,就能避开大多数环境问题:
“用哪个 Python 运行,就用哪个 Python 安装依赖。”
完成 Python、pip、虚拟环境和 PyCharm 解释器配置后,就可以开始编写自己的第一个 Python 程序了。