新手学Python,十有八九都卡在第一步:装好之后不知道环境变量是什么,装完PyCharm又连不上解释器,最后整到怀疑人生。这篇文章就围绕Python 3.9.7在Windows系统下的下载安装、环境配置,以及PyCharm的安装和关联使用,把这些环节从头到尾掰开揉碎讲清楚。适合刚入门、完全零基础的小白,也适合装了好几次没成功的人照着本地手抄一遍,彻底把环境理顺。
我平时帮人排查环境问题,见得最多的不是代码报错,而是安装阶段留下的隐患——比如PATH没勾、解释器指错、pip版本混乱。这些问题在第二天写代码时才会集中爆发,排查起来比装环境本身麻烦得多。所以这篇文章不只写“怎么装”,更要把每一步为什么这么做的道理讲明白,让你装完一次,之后不再反复折腾。
1. 为什么选Python 3.9.7,以及下载前先看这四件事
1.1 版本选择背后的逻辑
很多人一上来就问“是不是装最新版最好?”其实对初学者来说,Python的版本选择要看三个东西:稳定性、第三方库兼容性、教程匹配度。Python 3.9.7属于3.9系列的维护版本,发布于2021年下半年,修复了此前版本的大量bug,同时兼容绝大多数常用第三方库。相比最新的3.12、3.13,3.9.7可能不算新,但好在市面上大量的教材、网课、开源项目都基于3.8到3.10这个区间写代码,用3.9.7踩坑的概率最低。
我自己实际开发中也常年在3.9和3.10之间切换。有些老项目用到了较重的科学计算库,3.9.7的wheel二进制包基本都能直接装上,不需要编译,这对Windows用户特别友好。如果你用的是最新版Python,某些库还没发布对应版本的预编译包,安装时就会现场编译,报一堆乱码错误,新手一看就崩。选3.9.7,本质上是用“稍微保守的版本”换“极其顺利的安装体验”,这笔账很划算。
还有个细节:3.9.7是Python官方在Windows平台上提供64位和32位两种安装包的版本。现在的电脑几乎都是64位,但如果你要对接一些旧驱动或者特殊硬件,可能会遇到32位库的限制。下载前先确认自己的系统位数,这个我在下一小节细说。
1.2 下载前的系统信息确认
打开Windows设置,进入“系统”->“关于”,在“设备规格”里能看到“系统类型”是64位还是32位操作系统。绝大多数现代电脑都是64位,选择64位的Python安装包即可。如果你不确定,宁可下载64位版本——现在32位Python的第三方库支持越来越少,没必要给自己埋坑。
还有一个容易忽略的点:Windows 7和Windows 10/11对Python版本的支持范围不同。Python 3.9.x官方支持Windows 7 SP1以上系统,但如果你还在用老旧的Windows 7,必须确保系统已安装Service Pack 1,否则安装程序可能直接报错。Windows 10和Windows 11用户基本不用操心这个。
另外看一下C盘剩余空间。Python本体安装后占用大概300MB到500MB,PyCharm则要2GB以上,加上虚拟环境和第三方包,建议至少预留5GB。别小看这个检查,我见过有人C盘只剩几百MB,安装到一半直接失败,然后跑来问是不是安装包坏了。
1.3 官方下载渠道与安装包选择
Python的官方下载地址是python.org,进入后把鼠标悬停在Downloads菜单上,选择Windows,会看到所有版本列表。这里不建议点首页那个大大的黄色按钮,因为那个通常是当前最新版本,我们要的是指定版本3.9.7。在版本列表里找到“Python 3.9.7”,点击进入下载页,提供了多个安装包格式:
- Windows installer (64-bit):64位图形化安装包,推荐大多数人选择
- Windows installer (32-bit):32位图形化安装包,特殊情况下用
- Windows embeddable zip file:嵌入式版本,一般不用,主要是用于打包分发场景
下载时注意文件名里的“amd64”字样代表64位,没有则可能是32位。下载完成后先别急着双击安装,放到一个好找的位置,比如D盘根目录或者桌面新建的Python文件夹里,方便后续管理。
顺带说一句:不要在搜索引擎里点那种“高速下载”的推广链接,很多下载站捆绑了全家桶软件,甚至篡改安装包。Python官网下载速度一般都能接受,实在慢就换个时间段再试。安全比速度重要得多。
2. Windows环境配置全流程,这一步偷懒后面全是坑
2.1 安装过程中的关键选项
双击下载好的python-3.9.7-amd64.exe,进入安装界面,第一眼就能看到两个选项:“Install Now”和“Customize installation”。这里有一个对新手极其重要的细节:安装界面最下方有一个复选框“Add Python 3.9 to PATH”,务必勾选上。
我可以负责任地说,十个人里有五个人装完环境变量配置失败,就是因为没勾这个框。它的作用是把Python的安装目录自动写入系统环境变量PATH中,这样你在任何目录下的命令行窗口敲“python”都能直接启动解释器。如果不勾,后期虽然可以手动补,但对新手来说操作繁琐,还容易写错路径。
我建议勾选“Add Python 3.9 to PATH”后,直接点击“Install Now”走默认安装。默认安装路径是C盘的用户目录下的AppData\Local\Programs\Python,好处是不需要管理员权限,以后卸载也更干净。但如果你有洁癖,希望Python装在D盘或者其他路径,就点击“Customize installation”,然后在“Install Python to a custom location”里指定路径。
强烈建议安装路径里不要出现中文和空格。有些老库和工具链对中文路径支持不好,你辛辛苦苦写完代码,import一个库突然报错,查半天才发现是路径问题。装到D:\Python39这种纯英文路径,能让之后省掉很多莫名其妙的麻烦。
2.2 PATH环境变量的本质理解与验证
环境变量PATH到底是什么?我习惯把命令行想象成一个外卖员,你在命令行输入“python”相当于点了“送一份Python到当前位置”的订单,系统需要知道Python在哪,才能把他送过来。PATH就是一张地址表,记录了各类程序所在的目录,系统拿到“python”这个订单后,会按顺序在PATH记录的每一个目录里寻找有没有对应的可执行文件。
安装时勾选了“Add Python 3.9 to PATH”,系统会自动把三个路径写入PATH:Python安装目录本身、Scripts子目录(存放pip等工具)、以及可能的一些工具目录。这三个都很重要,尤其是Scripts目录,因为后面用pip安装第三方包时,pip.exe就存放在这里。
装完之后怎么验证呢?按Win+R,输入cmd回车,打开命令行窗口,输入:
python --version如果看到“Python 3.9.7”字样,说明安装成功且环境变量生效。这里我多说一句:如果输出的是“Python 3.9.7”之外的其他版本,比如3.8或者3.10,说明电脑上已经存在其他Python版本,新旧版本的环境变量可能冲突了,这种情况我们到第5章排查部分再展开。
再验证pip:
pip --version出现类似“pip 21.2.4 from ... (python 3.9)”的提示就算正常。这一步同样重要,因为后续安装pandas、requests这类库全靠pip。
2.3 命令行里测一下Python的基本功能
环境变量配好只是第一步,我习惯在命令行里顺手敲两行代码,确认解释器能正常工作。在cmd里输入python,进入Python交互式界面,然后输入:
print("hello")回车看到输出了hello,接着输入exit()退出。这个测试看起来简单,但能确认解释器本身没损坏、系统环境能正常加载Python。装完环境就卡在这一步的人确实有,直接双击python.exe能打开,但命令行就是报错,这种情况多半和PATH配置有关。
还有一个容易被忽略的细节:Windows的系统环境变量和用户环境变量是分开的。如果安装时以当前用户身份安装Python,写入的是用户变量;如果安装程序弹出了UAC管理员授权,写入的可能是系统变量。这两种正常情况下都能用,但如果你用另一个Windows账户登录电脑,用户变量那套就看不到了。家用电脑一般没这个问题,公用电脑需要注意。
环境配置这块我给新手的最终建议是:安装时勾选PATH、用纯英文路径、装完先测python --version和pip --version两行命令,确认无误再进入下一步PyCharm安装。不要急着写代码,环境稳了,后面一切都顺。
3. PyCharm的安装与解释器关联,把Python“接”进IDE
3.1 社区版还是专业版,该怎么选
PyCharm是JetBrains出品的Python IDE,也是目前用得最广泛的Python开发工具。JetBrains旗下工具都以“智能”著称,代码补全、错误提示、重构功能非常强,对新手来说能少踩很多打错缩进和拼写的坑。
PyCharm分两个版本:社区版(Community)和专业版(Professional)。社区版是完全免费的,支持Python开发的核心功能,包括编辑器、调试器、版本控制、虚拟环境管理等,对个人学习和小型项目完全够用。专业版则需要付费订阅,额外支持Web开发框架(如Django、Flask)、数据库工具、远程开发等功能。
我的建议是:学生和初学者直接用社区版,免费且功能充足,没必要为了“专业版”三个字提前付费。等以后真的需要用Django做Web项目、需要连接数据库操作时,再考虑是否升级也不迟。千万不要在非官网渠道下载所谓的破解版或激活码工具,一来有安全风险,二来违背软件版权规范。使用免费合法的社区版,是最稳妥、最安心的选择。
3.2 PyCharm的下载与安装过程
PyCharm官方下载地址是jetbrains.com/pycharm,进入页面后点Download。页面通常显示专业版和社区版两个下载入口,选择Community版下方对应Windows的下载链接,会得到一个.exe安装文件,体积大约400到500MB。
双击安装文件,一路Next,到Installation Options这一步时注意几个选项:
- “64-bit launcher”:在桌面创建快捷方式,建议勾选
- “Add launchers dir to the PATH”:将PyCharm启动命令加入PATH,不勾也行,不影响日常使用
- “Add 'Open Folder as Project'”:右键菜单里增加“用PyCharm打开文件夹”的选项,建议勾上
- “Create Associations”里的“.py”:让.py文件默认用PyCharm打开,新手建议勾选
安装路径同样建议放在非C盘或至少一个明确的位置,比如D:\JetBrains\PyCharm。安装完成后首次启动会有一个主题选择:Darcula是黑色主题,Light是白色主题。这个纯粹看个人喜好,我推荐黑色,长时间写代码眼睛舒服一点,当然有些人喜欢白底,各取所需。
3.3 在PyCharm中配置Python解释器
首次启动PyCharm时会进入Welcome界面,询问“New Project”还是“Open”。先不急着新建项目,我建议先确认解释器配置的逻辑,再动手。PyCharm本身是一个编辑器外壳,Python代码要运行必须指定系统里哪个Python解释器来执行它,这个解释器可以是你刚安装的3.9.7,也可以是某个虚拟环境里的Python。
新手最容易犯的错是:玩命在哪里找“配置解释器”的设置页,其实在新建项目时就能直接关联。点击“New Project”,左侧选择Pure Python,然后在右侧“Base interpreter”一栏点击展开,如果之前在Windows上正确安装了Python 3.9.7,这里会自动识别出“Python 3.9”的选项。选中它,PyCharm会自动基于这个基础解释器创建一个新虚拟环境(Virtualenv)。
虚拟环境是另一个重要概念:每个项目可以有一个独立的Python运行环境,里面安装的第三方包互不干扰。PyCharm默认勾选“Create a new virtual environment”,生成在项目目录下的venv文件夹中。这个设计非常好,以后你开发A项目装库不会污染B项目。就算你现在还理解不了虚拟环境的深层意义,也建议保持默认选项,让PyCharm替你管理。
如果新建项目时Base interpreter下拉框里是空的,说明PyCharm没有自动识别到Python安装位置。点击下拉框右侧的“...”,手动找到你安装Python的目录,选择python.exe就行。比如默认安装路径一般是C:\Users\你的用户名\AppData\Local\Programs\Python\Python39\python.exe。选好后PyCharm会重新扫描一次环境,解释器状态变为可用即可继续。
配置完成后,在PyCharm右下角能看到当前项目的Python版本信息,写作“Python 3.9(项目名)”这样的格式。这相当于启动引擎的钥匙插好了,下一步就能真正写第一行代码了。
4. 第一个项目实战:从新建到运行,彻底打通全链路
4.1 新建项目的关键设置
前面说到点击New Project后,选择Pure Python,接下来有几个设置项要好好看:
- Location:项目存放位置,建议放在D盘某个统一目录下,比如D:\PythonProjects\myFirstProject。千万别放在桌面或中文目录,这点和第2章说的路径坑同理。
- Base interpreter:选择系统里安装的Python 3.9.7
- Virtualenv:保持勾选,创建一个新的venv虚拟环境
点击Create,PyCharm会开始初始化项目。首次创建项目时会自动下载一些基础组件,比如pip、setuptools,这一步需要联网,耐心等一会儿。初始化完成后,左侧Project窗口里会看到一个main.py文件,这就是程序的入口文件。
我先解释一下这几层关系:项目是最外层容器,虚拟环境在项目内部,而虚拟环境里的Python又指向你安装的Python 3.9.7。这么设计的好处是:每个项目能独立管理自己依赖的库,即便你未来某个项目需要Python 3.8或3.10,也不影响3.9.7这个项目。这个架构理念在正规开发中是基础中的基础,建议从第一天就建立起来。
4.2 写一个带依赖库的Demo小程序
只有hello world太没意思了,我建议写一个能实际用到第三方库的小程序,顺便测试pip安装流程。在PyCharm里先写一段基础逻辑,比如计算一组数据的平均值、最大值和最小值,用Python内置函数就能实现。先跑通基础代码,确认解释器没有毛病。
然后我们引入一个实际常用的库——requests。这个库用来发HTTP请求,是学习爬虫和调用API的入门必备。在PyCharm下方点击Terminal,进入项目终端,输入:
pip install requests如果网络没问题,pip会从Python官方PyPI仓库下载并安装requests库。装完后在main.py里写:
import requests response = requests.get("https://www.example.com") print("状态码:", response.status_code) print("页面长度:", len(response.text))点击右侧绿色三角形运行按钮,下方Run窗口会输出状态码200和一行数字。这说明两件事:第一,解释器正常;第二,第三方包成功安装并被代码调用。能做到这一步,说明你的Python环境、PyCharm、pip、虚拟环境整条链路已经完全打通了。
这里我要特别提醒:如果看到的是红色的错误信息,不要慌。先看最底部的异常类型,比如ModuleNotFoundError代表库没装上,ConnectionError代表网络问题。把错误信息复制下来去搜索,比盯着屏幕发呆有效得多。
4.3 包管理与虚拟环境的高频操作
实际开发中,我们要处理的不止一个requests库。随着项目变大,依赖越来越多,就需要一套管理方法。pip install xxx是安装,pip uninstall xxx是卸载,pip list查看当前环境里所有已安装的包,pip install -r requirements.txt则能批量安装项目所需的全部依赖。
虚拟环境相关的操作也要熟悉。每次新建项目时PyCharm都会创建一个venv文件夹,这个文件夹里放的就是这个项目独立环境的所有内容。如果硬盘空间紧张,或者某个项目的虚拟环境坏了,可以直接删掉venv文件夹,再通过PyCharm右上角的“Python解释器设置”里重新创建。这个操作不会影响系统的Python3.9.7,因为虚拟环境本质上是原版Python的一份独立拷贝。
还有一个高频需求是导入已下载的第三方包到项目里。比如在PyCharm左下角的Python Packages标签页里,能看到当前环境所有已安装的包,点击加号可搜索安装新包。这比每次敲命令行直观得多,新手入门阶段可以直接用这个界面管理包,等到习惯命令行了,再切换回Terminal敲pip命令,都不冲突。
4.4 从纯黑命令行到IDE操作的对照认知
我遇到不少新手想不明白“为什么已经有了命令行,还需要PyCharm?”其实这是个好问题。命令行里能完成的,PyCharm确实基本都能做,但PyCharm的增量价值在三个方面:编码时的实时错误检查、变量调试的图形化界面、工程文件的可视化管理。
你可以做个小实验对比一下:用记事本手动写一个带错误缩进的Python文件,然后放到命令行用python执行,报错信息需要自己盯着看。同样的文件放到PyCharm里,保存瞬间就能看到波浪线的提示,鼠标移过去甚至能看到具体错误描述。这个体验差异就是IDE存在的意义——把容易出错的部分尽可能拦截在运行之前。
当然,命令行也不能完全不碰。至少python --version、pip --version、pip list这几个基础命令要会,因为未来你会在服务器上部署Python项目,那上面没有IDE,只有命令行。平时在PyCharm的Terminal里多敲几次,就能两边的能力都补齐。
5. 常见问题排查实录:新手最容易踩的坑都在这里
5.1 输入python提示“不是内部或外部命令”
这个报错可以说是环境配置阶段出现频率最高的问题,几乎每天都能在技术群里看到。原因很直接:系统没有在PATH中找到python.exe。绝大多数情况就是安装时没勾“Add Python 3.9 to PATH”,或者安装完成后系统没有刷新环境变量。
解决方案有两个思路。第一是重新运行Python安装包,选择Modify,在下一步中把“Add Python to environment variables”选项开启;第二是手动配置PATH:右键“此电脑”->“属性”->“高级系统设置”->“环境变量”,在“系统变量”里找到Path,把Python安装目录(比如D:\Python39)和Scripts目录(比如D:\Python39\Scripts)追加进去。追加时注意用分号分隔,别把原来的变量值覆盖了。
改完环境变量后,一定要关闭所有已打开的cmd窗口重新打开,因为环境变量在窗口启动时就被读取了,旧窗口里改完也不生效。或者在新窗口里输入:
where python这个命令会列出所有在PATH下找到的python.exe位置。如果什么都没输出,说明PATH里还是没有Python;如果输出了多个路径,说明系统里装了多个Python,存在版本冲突。
5.2 PyCharm右下角显示“No interpreter”
这个问题通常出现在打开别人发来的项目或者之前用旧电脑创建的工程时。PyCharm不知道项目该用哪个Python来运行,于是显示“无法解析解释器”。解决办法:菜单栏File -> Settings -> Project -> Python Interpreter,点击右侧齿轮图标ADD,选择“Add Local Interpreter”或“Existing”找到python.exe。
这里要区分两种选择:如果项目自带了venv虚拟环境文件夹,最好选择Existing,并指向venv目录里的python.exe;如果项目没有任何环境文件,选择Add Local Interpreter创建新的虚拟环境更省事。不管选哪种,最终右下角显示出一个可用的Python版本即可。
还有一个我见过很多次的场景:新手把项目文件夹从A电脑拷贝到B电脑,venv里的路径还是A电脑的绝对路径,导致PyCharm报错。这种情况别去改配置文件,直接把venv文件夹删掉,重新让PyCharm创建新的虚拟环境,再把旧依赖用pip重新装一遍。很多人在venv维护上浪费时间,其实最简单的处理就是重建。
5.3 pip安装第三方库太慢甚至超时
使用默认PyPI源时,国内网络环境下载包经常很慢,尤其是pandas、matplotlib这类体积较大的库。这种情况下推荐换用国内镜像源,比如清华、阿里云等提供的PyPI镜像。临时用法是在pip命令后加-i参数:
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple更省心的做法是永久设置镜像源,在用户主目录下创建pip.ini配置文件,Windows路径通常是C:\Users\你的用户名\pip\pip.ini,写入:
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host = pypi.tuna.tsinghua.edu.cn设置之后pip默认使用镜像源下载,速度快非常多。不过遇到个别冷门包镜像源没有收录时,可以临时把index-url换回官方源,或者切换到其他镜像源试试。
使用镜像源时也要留意安全性。我个人的习惯是:至少使用规模大、维护成熟的镜像站,比如阿里云、清华等,不要随意使用来路不明的第三方源,避免下载到被篡改的包。
5.4 PyCharm运行代码报“Cannot find reference”警告
这个和报错还不一样,它更像一个智能提示,鼠标悬停时通常会显示类似“Cannot find reference 'xxx' in 'init.py'”的黄色警告。很多新手看到就慌,觉得代码还没跑就要挂了。其实这种警告大多数情况下是PyCharm的静态检查索引没有更新,尤其刚安装完新库时容易出现。
解决办法是把PyCharm的索引重建一下:菜单栏File -> Invalidate Caches,勾选Clear file system cache and Local History,然后点击Invalidate and Restart。PyCharm会重启并重新索引整个项目,警告往往就消失了。如果问题是特定的某个库,确认库本身安装正常,那忽略这条警告也不影响运行。学会区分“警告”和“报错”很重要,警告是黄色,报错是红色,两者权重完全不同。
5.5 跑了半天代码发现用的是旧版本Python
有一种隐藏很深的问题:系统里本来就装了Anaconda或者别的Python,PyCharm里选择的解释器却不是自己配置的3.9.7。代码能跑,但是某些包装不上或者行为怪异,查来查去发现解释器路径指向了别的地方。
我的建议是在每个项目里都通过右击项目根目录 -> Open in Terminal,先输入python --version确认一下当前终端里的Python版本,再检查PyCharm右下角的解释器信息,两边一致才能保证代码运行的确定性。如果你通过conda等工具管理Python,还要注意conda环境和纯Python环境的区别,别混用。
另外新老版本切换时,pip的默认指向往往是最容易出错的。改环境变量时多核对一次“which python”和“pip --version”是否指向同一个Python路径,如果pip指向3.9但python指向3.8,后续装库就会产生错位。命令行的“扯皮”问题,九成出在这里。
5.6 常见问题速查表
| 问题现象 | 根本原因 | 快速解决方案 |
|---|---|---|
| 提示python不是内部或外部命令 | PATH未配置Python目录 | 重装并勾选Add to PATH,或手动追加环境变量 |
| 提示pip不是内部或外部命令 | Pip工具目录未加入PATH | 检查Scripts目录是否在PATH中,未加入则手动添加 |
| PyCharm没有解释器可选 | 系统Python未安装或PyCharm未扫描 | 手动选择python.exe路径,或重装Python后重启PyCharm |
| pip下载慢或超时 | 连接官方PyPI网络不稳定 | 配置国内镜像源,临时加-i参数 |
| 运行代码报ModuleNotFoundError | 第三方库未安装到当前环境中 | 确认使用正确的虚拟环境,重新pip install |
| 系统中有多个Python版本互相干扰 | 新旧版本PATH冲突 | 清理环境变量,用where python查看并删除多余路径 |
| PyCharm提示无法创建虚拟环境 | Python路径包含中文或权限不足 | 装到纯英文目录,或给用户管理员权限 |
个人实操体会与最后的小建议
环境配置这件事,说到底就是“版本对上、路径清晰、解释器指定”这三个核心。我帮人排查过不下百次环境问题,结论永远是:宁可安装时多花两分钟看清每个选项,也别等代码报错后再满世界查教程。装好后花十分钟把python --version、pip --version、PyCharm解释器这三点验证一遍,之后的学习路径会顺畅非常多。
最后再分享一个小技巧:如果你以后要写多个项目,建议把项目统一放在一个纯英文目录下,比如D:\PythonProjects,不要放在C盘用户目录深处。因为路径越深、含中文或空格的路径越多,出问题的概率就越大。Python 3.9.7加PyCharm社区版这套组合,我实际测试下来非常稳定,足够支撑你从零基础走到独立开发完整项目。环境装好只是起点,真正值钱的是你接下来每一天的代码练习。把这套环境跑通,后面写代码的路就顺了。