简介面向零基础编程入门者的环境搭建图文教程围绕 Python 解释器与 PyCharm 集成开发环境的安装、激活与联调展开帮助初学者在一台电脑上快速完成从下载安装包到跑通第一个项目的完整准备工作。压缩包内为 1 个 docx 文档体积约 1.29MB以分步骤文字说明配以官方下载地址的形式组织依次覆盖官网安装包的选择与安装选项勾选、IDE 的下载安装流程、激活码填写以及新建项目时解释器的绑定配置条理清晰可照着逐步操作。已有 473 人学习下载适合刚接触 Python、对 IDE 配置不熟悉的学生与转行自学者作为上手参考也可供需要批量搭建教学机房环境的教师快速核对关键步骤。文中对 pip、IDLE 等组件的作用与安装取舍、解释器路径选择等易错环节均有所交代能减少新手在环境变量与激活环节反复试错的成本。1. 先把 Python 和 PyCharm 的版本对齐再谈安装一台刚重装完系统的机器上装 Python 和 PyCharm 大概是最不起眼、也最容易返工的一步。上周我就碰上一次照着那份流传很广的 docx 步骤走Python 选 3.9.5、PyCharm 选 2021.2.1装完一开项目解释器那一栏直接标红pip 装依赖装到一半报编译错误来回折腾一个多小时才发现是版本组合加 PATH 没生效。这套环境几乎每个写 Python 的人都要装一遍装顺了十分钟收工装拧了能卡一整天而且症状都很像——命令行敲 python 没反应、IDE 找不到解释器、pip 卡在下载。这篇记录按我实际落地的顺序写怎么挑版本、安装向导里哪几个勾不能乱点、解释器怎么绑到项目上、装坏了先看哪里。刚换机器要重建环境的人照着走一遍就行手上已经有一套、但总觉得别扭的也可以对着中间几节核一遍。2. 下载并安装 Python安装包上那个勾到底勾不勾2.1 版本选择3.9.5 是当年的下限不是现在的默认原始文档里写的是 Python 3.9.5这个版本放在它写作的时间点没问题但今天再照着装就不太合适了。3.9 分支已经停止维护只收安全修复3.8 更早就退出支持了。真正该考虑的是两条线一条是稳一条是新。稳妥路线选 3.11第三方库覆盖最全绝大多数教学项目、数据处理脚本、Web 框架都能直接跑新一点选 3.12性能更好但个别老库的预编译包还没跟上装依赖时容易退化成源码编译Windows 上就需要本机有编译工具链新手很容易在这里卡住。还有一个容易被忽略的约束IDE 版本会限制你能用的 Python 版本。PyCharm 2021.2.1 这个版本对 3.10 之后的语法支持不完整比如结构化模式匹配、部分类型标注写法会标红但代码其实能跑这种“假报错”最折磨人。所以版本组合要么一起新要么一起旧别一边装 3.12 一边用 2021 年的 IDE。Python 版本维护状态建议场景主要风险3.8已停止支持维护老项目新库不再提供安装包3.9仅安全修复复现旧教程部分新库已放弃支持3.11稳定维护默认首选几乎没有3.12活跃维护新项目少数库缺预编译包3.13活跃维护尝鲜生态适配滞后我的做法是主力机装 3.11需要复现老项目时再单独装一个 3.9两个解释器共存完全没问题Windows 上靠 py 启动器切换后面会讲。2.2 安装向导逐项拆Add python.exe to PATH 的后果下载页在 python.org 的 Windows 分区选 “Windows installer (64-bit)” 那个 exe别选 embeddable package——那是给嵌入到别的程序里用的精简包没有 pip没有标准库的一部分装完你会发现什么都没法干。双击进入向导第一屏底部有两个勾Install launcher for all users装 py 启动器建议勾上后面多版本共存全靠它。Add python.exe to PATH这个必须勾。不勾的话命令行里敲 python 会直接提示找不到命令PyCharm 有些版本也检测不到解释器。很多人装完发现“Python 装了但用不了”九成是这里没勾。然后点 “Customize installation” 而不是 “Install Now”。默认路径是C:\Users\你的用户名\AppData\Local\Programs\Python\Python311这个路径本身没空格但如果你的 Windows 用户名是中文整条路径就带中文了后面跑脚本、编译 C 扩展的时候会遇到各种编码和路径解析问题。我一般直接改成C:\Python311短、无空格、无中文省掉后面一堆麻烦。Optional Features 那一页Documentation、pip、tcl/tk and IDLE、Python test suite、py launcher 全勾上其中 pip 是必须的。Advanced Options 那一页Install for all users勾上装到 Program Files 之外的公共目录其他账户也能用。Associate files with Python勾上双击 .py 文件直接用 Python 打开。Create shortcuts for installed applications可勾可不勾。Add Python to environment variables勾上和前面那个 PATH 勾是同一个意思双保险。Precompile standard library勾上装的时候慢一点运行时快一点。如果是要批量装机器图形界面一项项点太慢可以直接用静默参数# 静默安装 Python 3.11.9全部用户可用自动写入 PATH python-3.11.9-amd64.exe /quiet InstallAllUsers1 PrependPath1 Include_test0 TargetDirC:\Python311/quiet表示不弹界面InstallAllUsers1对应“为所有用户安装”PrependPath1就是把安装目录塞到 PATH 最前面TargetDir指定安装目录。注意Include_test0是跳过测试套件能省几十兆空间。这条命令跑完不会有任何提示得自己去C:\Python311看文件在不在。2.3 装完先验三条命令别急着开 IDE安装向导最后一步有个 “Disable path length limit”问你要不要解除 260 字符的路径长度限制点掉它这是 Windows 的老问题项目里嵌套几层 node_modules 或者虚拟环境就会超。装完别急着开 PyCharm先开一个新的命令行窗口这点很重要旧的窗口读的是旧的环境变量改了 PATH 也不会生效敲下面几条# 1. 看 python 命令实际指向哪个可执行文件 where python # 2. 看版本号确认装的是不是你想要的那个 python -V # 3. 列出机器上所有已安装的 Python 版本 py -0 # 4. 确认 pip 挂在哪个解释器下面 python -m pip -Vwhere python如果列出多条第一条就是实际生效的顺序不对就去环境变量里调整。python -V输出Python 3.11.9这类信息就说明 PATH 生效了。py -0会列出所有版本前面带星号的是默认版本如果装了多个版本可以用py -3.9这样指定。python -m pip -V的输出里会带上 pip 所在路径如果这个路径指向的不是你刚装的目录说明机器上还有另一个 Python 在抢。提示python -m pip和直接敲pip是两回事。前者明确用当前解释器自带的 pip后者走 PATH 里第一个 pip多版本环境下经常对不上装包时我坚持用前一种写法。3. 安装 PyCharm社区版和专业版先把账算清3.1 下载哪个包社区版够不够用PyCharm 分社区版Community和专业版Professional。社区版免费支持纯 Python 开发、虚拟环境、调试器、重构、版本控制专业版收费多了 Web 框架专属支持Django、Flask 的模板和路由识别、数据库工具、远程解释器、科学计算模式。写脚本、刷题、做课程项目社区版完全够做 Web 后端或者要连远程服务器跑代码才需要考虑专业版。下载页在 JetBrains 官网的 PyCharm 分区选对应系统的安装包。原始文档里给的版本是 2021.2.1如果你的 Python 是 3.11 以上别用这么老的 IDE去下当前版本否则语法高亮和类型检查会一直报假错。反过来如果机器是 32 位系统或者内存只有 4G老版本反而更轻快2021.x 系列启动比现在的新版快不少——这是版本取舍不是越新越好。安装包大小在一两个 G下载慢的话可以先用离线包。装之前把旧的 PyCharm 关干净任务管理器里确认没有残留的 java 进程不然安装程序会提示文件被占用。3.2 安装向导里的四个勾选项PyCharm 的安装向导比 Python 简单但几个勾选项影响日常使用Create Desktop Shortcut勾 64-bit 那个桌面留个图标。Update PATH variable勾上会在 PATH 里加一个bin目录之后可以在命令行用pycharm命令直接打开项目写脚本自动化的时候有用。Update context menu勾 “Add Open Folder as Project”在任意文件夹右键就能用 PyCharm 打开比先开 IDE 再选目录快得多。Create Associations勾 .py双击 Python 文件默认用 PyCharm 打开。如果你同时装了 VS Code这里想清楚再勾不然会抢默认程序。安装目录默认在C:\Program Files\JetBrains\PyCharm 2024.x带空格。一般不影响使用但如果后面要写脚本调用 IDE 的命令行工具路径里的空格得用引号包起来。我习惯改成C:\JetBrains\PyCharm少一层麻烦。装完第一次启动会问要不要导入旧配置全新机器选 “Do not import settings”。然后是一堆插件推荐全部跳过尤其是那些主题、AI 补全之类的插件先让 IDE 干净地跑起来需要再加。3.3 授权方式社区版、试用期和那个 License server原始文档里写的激活方式是“选择 License server填入一个 http 开头的地址点 Active”。这条路我试过后来不用了原因很实际这类第三方激活服务器随时会挂今天能用明天就 403而且它要求你的 IDE 把授权校验请求发到一台不受你控制的机器上出问题的概率不低。更要紧的是不合规公司或者学校环境里被查到很麻烦。正经的几条路按推荐顺序直接用社区版。免费、合规、功能对纯 Python 开发够用唯一缺的是 Web 框架和数据库工具这些用命令行和第三方客户端也能补。专业版 30 天试用。新装的 IDE 自带一个月完整试用做短期项目、赶一次课程设计足够了到期后 IDE 会退回受限模式不会锁死你的项目文件。教育/开源授权。学生和教师身份可以申请免费的教育授权开源项目维护者也有对应的免费授权通道这是 JetBrains 官方给的合规且长期有效需要提交证明材料审核一般几天。公司统一采购。团队规模上来了走这条路人均成本比个人订阅低还带统一管理。如果你现在装的版本已经弹了授权窗口先看清楚窗口左下角有没有 “Evaluate for free”有就点它进试用没有说明你下的是社区版本来就不需要授权。已经填过第三方服务器地址、IDE 反复弹窗的把配置目录里的授权缓存删掉重来Windows 下在C:\Users\用户名\AppData\Roaming\JetBrains\PyCharm2024.x里找到带 license 字样的文件删掉重启 IDE 就会回到初始授权界面。注意网上流传的各种“永久激活脚本”“补丁 jar 包”本质是改 IDE 的校验逻辑杀毒软件报毒是常态而且新版本 IDE 会校验自身文件完整性改完直接起不来。装环境是为了写代码不是为了修 IDE别在这上面耗时间。4. 配置解释器让 PyCharm 认出你装的那个 Python4.1 新建项目时把解释器定死PyCharm 启动后第一屏是欢迎界面点 “New Project”。这个界面里最关键的字段是Python Interpreter它决定了这个项目用哪个 Python 跑。下拉框里通常会有几个候选C:\Python311\python.exe—— 你刚装的那个选它。C:\Users\用户名\AppData\Local\Programs\Python\...—— 之前装过的残留别选。一个叫 “Project venv” 的选项 —— 这是新建虚拟环境下一节讲。如果下拉框里空空如也点右边的齿轮或者 “Add Interpreter” → “System Interpreter”手动浏览到C:\Python311\python.exe。选完之后 IDE 会在下面显示识别到的版本号和 pip 版本版本号对不上就是你选错了文件。路径里有个细节一定选python.exe不要选pythonw.exe。后者是无控制台版本用来跑 GUI 程序的选它之后 IDE 拿不到标准输出print 的内容全丢调试时一脸懵。项目建好之后解释器信息可以在File → Settings → Project: 项目名 → Python Interpreter里改这里能看到当前环境装了哪些包也是后面装依赖的主入口。4.2 虚拟环境每个项目一个别省这一步直接在全局解释器里pip install是最省事也最容易出事的做法。项目 A 要 requests 2.25项目 B 要 requests 2.31装到一个环境里必然打架症状是“代码在 A 里能跑在 B 里报 ImportError”。虚拟环境就是为了解决这个每个项目一个独立目录包各装各的。在新建项目界面选 “Project venv”或者手动建# 在项目根目录创建虚拟环境目录名 .venv 是社区习惯 C:\Python311\python.exe -m venv .venv # 激活PowerShell .\.venv\Scripts\Activate.ps1 # 激活cmd .\.venv\Scripts\activate.bat # 确认当前用的是虚拟环境里的解释器 where python-m venv是标准库自带的模块不需要额外装东西。.venv这个目录名不是强制的但 PyCharm 默认会识别这个名字并自动关联。激活之后命令行提示符前面会多一个(.venv)这时候pip install装的包全部落在项目目录里跟系统 Python 无关。where python应该指向.venv\Scripts\python.exe如果不是激活没成功。PowerShell 下执行激活脚本经常报这个错无法加载文件 ...\Activate.ps1因为在此系统上禁止运行脚本这是 PowerShell 的执行策略在拦不是脚本有问题。改一下策略就行# 只对当前用户放开本地脚本执行不需要管理员权限 Set-ExecutionPolicy -Scope CurrentUser RemoteSignedRemoteSigned的含义是本地写的脚本可以跑从网上下载的脚本必须有签名。这个级别比Unrestricted安全比Restricted实用是开发机的常规配置。改完重开一个 PowerShell 窗口再激活就正常了。在 PyCharm 里创建项目时如果勾了 “Project venv”IDE 会自动建好并把解释器指过去不需要手动敲命令。判断有没有生效看右下角状态栏显示Python 3.11 (.venv)就对了。4.3 pip 源与依赖装不上包时先换源再怀疑人生国内网络环境下pip install卡在 “Collecting” 或者下载速度只有几 KB 是常态。这不是 pip 坏了是默认源在国外。换成国内镜像速度立刻正常# 全局设置默认源写入用户目录下的 pip.ini python -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple # 设置信任该源避免个别环境下的证书告警 python -m pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn # 查看当前生效的配置 python -m pip config list这三条命令只对当前解释器生效注意别在虚拟环境里配完就以为全局都配好了。如果是多环境都要用在每个环境里各跑一次或者直接编辑配置文件Windows 下路径是%APPDATA%\pip\pip.ini内容长这样[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cn timeout 60timeout默认是 15 秒装大包比如 numpy、pandas的时候经常超时中断调到 60 秒容错空间大很多。trusted-host是跳过该源的 HTTPS 证书校验某些内网环境会替换证书加上这行能少一类莫名其妙的 SSL 报错。装包的时候还有个习惯先用python -m pip install --upgrade pip把 pip 本身升到最新。老版本 pip 对新版包格式的兼容性差很多“装不上”其实是 pip 太旧。升级完再装业务包报错信息会清晰得多。如果某个包在 Windows 上需要编译 C 扩展而失败优先找带cp311之类标签的预编译 wheel 包实在没有再考虑装编译工具链那是另一个话题了。5. 避坑排查装完却跑不起来的五类现场5.1 敲 python 弹出应用商店或者提示不是内部或外部命令现象新开的命令行里输入python要么跳转到 Microsoft Store要么报 “python 不是内部或外部命令”。原因前者是 Windows 10/11 自带的应用执行别名在作怪系统里预置了python.exe和python3.exe两个空壳指向商店安装入口优先级比真实解释器高。后者是安装时 PATH 没勾或者勾了但没重开命令行。解决打开“设置 → 应用 → 高级应用设置 → 应用执行别名”把python.exe和python3.exe两个开关关掉。然后确认 PATH控制面板 → 系统和安全 → 系统 → 高级系统设置 → 环境变量在用户变量的 Path 里应该有C:\Python311\和C:\Python311\Scripts\。改完必须重开命令行窗口旧窗口读的是旧值。如果还是不行用py -3.11绕过别名直接调启动器能跑就说明只是别名问题。5.2 装了 PythonPyCharm 里解释器一栏是红的现象新建项目后右下角显示No interpreter或者解释器路径标红代码里import全部报未解析。原因三种可能。一是选到了不存在的路径比如照着教程选了C:\Python39\python.exe但你装的是 3.11。二是虚拟环境目录被移动或删除IDE 缓存的路径失效。三是 IDE 的索引没刷新配置其实对但界面没更新。解决先点右下角解释器区域 → “Add Interpreter” → “System Interpreter”浏览到实际的python.exe确认版本号显示正确。虚拟环境失效的删掉项目里的.venv目录重新建一个再到Settings → Project → Python Interpreter里重新指向。索引问题用File → Invalidate Caches → Invalidate and Restart重建索引要几分钟期间别急着判断对错。5.3 pip install 卡住不动或者报 SSL 证书错误现象下载进度条长时间停在某个百分比最后超时或者直接抛SSLError: CERTIFICATE_VERIFY_FAILED。原因默认源在国外跨境链路不稳定SSL 报错通常是所在网络替换了证书或者系统时间不准导致证书校验失败。解决按上一节换成国内镜像源同时把timeout调大。SSL 报错先校准系统时间再考虑加trusted-host。如果换了源还是慢试试换个镜像地址不同镜像的同步频率和带宽不一样。注意别在项目里硬编码源地址配置写在 pip.ini 里换机器时拷一份过去就行。5.4 路径带中文或空格脚本运行时报编码错现象脚本能启动但读文件时报UnicodeDecodeError或者某个第三方库导入时提示找不到模块手动进目录看文件明明在。原因Python 安装目录、项目目录、Windows 用户名任意一层带中文或空格某些库在拼接路径、调用外部程序时会解析失败。老版本 Python 的默认编码是 GBK读写 UTF-8 文件也需要显式指定。解决安装目录改成纯英文无空格比如C:\Python311项目目录也放在D:\projects\xxx这种路径下。文件读写一律显式写encodingutf-8# 显式指定编码避免不同系统默认编码不一致 with open(data.txt, r, encodingutf-8) as f: content f.read()如果项目已经建在中文路径下迁移时记得把.venv删了重建虚拟环境里的路径是写死的直接挪目录会失效。5.5 授权窗口反复弹出项目打不开现象IDE 启动后只显示授权对话框点关闭就退出进不去主界面或者试用期显示还有 0 天。原因之前填过第三方 License server 地址服务器失效后 IDE 每次启动都去校验校验失败就卡住也可能是试用期确实到期了。解决先断网启动很多版本在无网络时会跳过校验进入受限模式至少能打开项目把代码导出来。然后删掉授权缓存目录AppData\Roaming\JetBrains\PyCharm版本号下带 license 的文件重启回到初始授权界面。要长期用就换社区版或者走教育/开源授权申请。别去下所谓的激活补丁改完 IDE 自检通不过反而更麻烦。6. 跑通验证用一个最小工程把环境和解释器一起验掉装完最后一步不是看 IDE 有没有打开是跑一个能同时验证解释器、包管理、编码、调试四件事的最小工程。我一般建一个空项目写三个文件# main.py —— 验证解释器版本、标准库、第三方库、文件编码 import sys import platform import requests # 第三方库用来验证 pip 是否装到了当前环境 def main(): print(解释器路径:, sys.executable) print(Python 版本:, sys.version.split()[0]) print(系统平台:, platform.platform()) resp requests.get(https://pypi.org/simple/, timeout10) print(第三方库请求状态码:, resp.status_code) with open(hello.txt, w, encodingutf-8) as f: f.write(环境验证通过\n) print(文件写入完成) if __name__ __main__: main()sys.executable是关键它输出的是当前真正在跑的解释器绝对路径这个值必须指向你的虚拟环境指向系统 Python 就说明配置没生效。requests用来验证 pip 装的位置对不对——如果 IDE 里 import 成功但命令行跑失败说明 IDE 用的是另一个环境。文件写入那一段同时验了编码和写权限。跑之前先在终端里装依赖# 确认在虚拟环境里然后装依赖 python -m pip install requests python main.py然后在 PyCharm 里右键main.py→ “Run main”看控制台输出。两边的sys.executable应该是同一个路径输出一致才算真跑通。接着下一行断点按 F8 单步走一遍调试器能停住、能看到变量值这套环境就算完整了。最后对一遍检查清单检查项期望结果不符合时看哪命令行python -V显示目标版本第 5.1 节sys.executable指向.venv目录第 4.2 节python -m pip -V路径与解释器一致第 2.3 节IDE 右下角解释器显示版本 (.venv)第 5.2 节断点调试能停住并查看变量IDE 设置里的 Debugger中文写入不报编码错误第 5.4 节有一年我在三台机器上装这套环境两次都栽在同一个地方装完 Python 直接开 IDEIDE 自动检测到了系统里残留的另一个 3.8项目就跑在老解释器上装包装到全局去等发现的时候已经装了一堆互相打架的版本。从那以后我每次装完都强制走一遍这条验证链where python→ 建 venv → 激活 →sys.executable打印路径 → IDE 里再跑一次两边对上了才开始写第一行业务代码。多花五分钟省掉的可能是一整天的排查。希望帮到你。本文还有配套的精品资源点击获取