简介面向刚接触 Python 编程的初学者、转行者以及需要搭建本地开发环境的高校学生这份 docx 文档围绕 Python 解释器与 PyCharm 集成开发环境的安装、激活和基础配置展开旨在降低环境准备阶段的检索与试错成本。压缩包内仅含 1 个 docx 文件大小约 1.29MB以文字说明承载完整流程便于离线阅读、按需查阅和反复对照。内容覆盖官方安装包获取、安装选项选择、License server 激活方式以及在 PyCharm 中指定 Python 解释器等关键环节可为后续编写、调试和测试 Python 代码提供可复用的环境准备参考。文档将工具安装与环境配置分开组织适合希望快速完成工具链初始化、建立规范开发入口的入门用户对于需要重装系统、切换 Python 版本或排查解释器路径问题的自学者也具备一定查阅价值。目前已有 473 人学习。1. 先定版本再动手Python 3.9.5 与 PyCharm 2021.2.1 装错比装不上更磨人装 Python 和 PyCharm出错的情况往往不是装不上而是装上了不好用。某开发者照着笔记一路点完cmd 里敲 python 弹出来的却是应用商店页面PyCharm 新建项目解释器下拉框空空如也代码区一片红。这两处都属于「看着成功、实际断链」比直接报错难查得多。这套环境几乎是每台 Windows 开发机的第一课一个 Python 3.9 解释器加一个 PyCharm 2021.2.1跑脚本、做课设、接数据处理的活都从这儿开始。装不好就是长期的玄学——PATH 没配对命令行永远找不到 python解释器绑错包装在 3.9 上、代码跑在别的版本上报错看着毫不相干。刚上手 Python 的、换新机器重搭环境的、帮人配机器不想现场翻资料的都适合照着走一遍。2. 装 Python3.9.5 安装包里那三个勾选项决定后面省不省事Python 的安装包本身很小二十多 MB双击到结束不超过三分钟。真正决定后面顺不顺的是安装向导里那几页复选框勾对了后面敲命令一路顺畅勾漏了得回去改环境变量、关系统别名、补 Scripts 目录来回折腾半小时。这一章按「下对包 → 勾对项 → 验证三连 → 多版本共存」的顺序走每一步都给出可抄的命令和判断依据。2.1 下载对的安装包别下成 embeddable 版本打开 Python 官网的 Windows 下载页python.org/downloads/windows同一个版本号下面挂着五六种文件第一次进去很容易点错。最常见的坑是下了Windows embeddable package (64-bit)那是个 zip 包解压出来确实有 python.exe也能跑最简单的脚本但它不带 pip、不带完整的标准库布局装第三方包会一路卡住。正确选择是Windows installer (64-bit)一个 exe。版本上原笔记举的例子是 3.9.5。这个版本对教学和老项目友好大量课程资料、第三方库文档都还停在这条线上。新机器上 3.10、3.11 也能用但要注意部分老库在 3.11 上还没发布预编译包pip 会转去本地编译机器上缺构建工具就直接失败。我一般给两类需求分开装跑课件和老项目的用 3.9玩新特性的单独装一个 3.11靠 py 启动器区分互不干扰。装的时候右键「以管理员身份运行」。第一页只有两个复选框Install launcher for all users (recommended)Add Python 3.9 to PATH← 这个必须勾第二个勾是整篇里性价比最高的一个勾。不勾装完在 cmd 里敲 python 就是「不是内部或外部命令」后面所有命令行操作都得手写全路径。勾上之后安装程序会把C:\Python39\和C:\Python39\Scripts\一起写进用户 PATH。接着点 Customize installation 进 Optional Features 页默认是全勾的Documentation、pip、tcl/tk and IDLE、Python test suite、py launcher。pip 这一项不能去掉去掉之后还得手动跑python -m ensurepip补回来。Documentation 可以取消省十几 MB无所谓。Next 到 Advanced Options 页几项这么处理Install for all users勾上会装到C:\Program Files\Python39路径带空格个别老工具链对空格敏感我一般不勾改用下面的自定义路径Associate files with Python勾.py 文件双击能直接运行Create shortcuts for installed applications勾Add Python to environment variables勾和第一页那个勾是同一件事双保险Precompile standard library勾首次启动快一点Customize install location改成C:\Python39安装路径这条建议直接写死不要放中文目录、不要放同步盘目录、不要带空格。中文路径在 pip 安装带 C 扩展的包时会失败报错信息还很不直观看着像包本身的问题其实是路径编码。2.2 装完验证三连python、pip、Scripts 目录安装向导走完别急着开 PyCharm先在命令行确认三件事# 1. 命令行实际调用的是哪个 pythonPATH 里从上往下命中的第一个 where.exe python # 期望输出C:\Python39\python.exe # 2. 版本对不对 python --version # 期望输出Python 3.9.5 # 3. pip 挂在哪个解释器上用 -m 比直接敲 pip 稳 python -m pip --version # 期望输出里应包含 C:\Python39\Lib\site-packageswhere.exe比python --version更有诊断价值版本对不代表路径对机器上装了多个 Python 时版本可能恰好蒙对路径才是真相。python -m pip这个写法也值得养成习惯——直接敲pip走的是 PATH 里第一个 pip.exe多版本机器上经常指向另一个解释器装完包在项目里 import 不到排查半天才发现装错了地方。如果python --version正常但pip报错多半是Scripts子目录没进 PATH。pip.exe、以后装出来的 pytest、black、virtualenv 这些命令行工具全在C:\Python39\Scripts下面。手动补的办法Win R 输入sysdm.cpl回车进「高级 → 环境变量」在用户变量里找到 Path新建两条C:\Python39\ C:\Python39\Scripts\改用户变量不用管理员权限也不会影响这台机器上的其他账户比改系统变量干净。改完必须重开命令行窗口已经开着的窗口读的是启动那一刻的环境快照改多少次都不会生效这一条踩过的人不少。另一个高频现象是敲 python 直接弹出应用商店。这是 Windows 的「应用执行别名」在作怪系统预置了两个占位 exe指向商店的安装页真 Python 没进 PATH 时命令就被它接管了。关掉的位置在「设置 → 应用 → 高级应用设置 → 应用执行别名」找到 python.exe 和 python3.exe 两个开关关掉再配合上面的 PATH 修复一起做。两件事只做一件问题还会回来。2.3 多版本共存py 启动器和 pip 源配置机器上原本就有别的 Python 发行版比如带 conda 的那套别硬删。装 3.9 时勾了 py launcher它会注册一个py命令按注册表里的顺序管理所有版本和 PATH 谁前谁后无关# 列出机器上所有注册的 Python带 * 的是默认版本 py -0 # 指定用 3.9 这一支不受 PATH 干扰 py -3.9 -m pip install requests # 指定版本跑脚本 py -3.9 hello.pypy -0的输出里带星号的那行是默认版本如果默认被 conda 抢走了用py -3.9显式指定就行。在 PyCharm 里则完全不用管这个解释器路径是手动指过去的跟命令行默认值互不影响。pip 换索引源这一步在国内网络环境下基本是必做项不然装个 requests 能等三分钟# 写入用户级配置只影响当前用户不动系统 python -m pip config set global.index-url https://你的镜像地址/simple python -m pip config set global.trusted-host 你的镜像地址 # 确认配置写进去了 python -m pip config listconfig set落盘的位置是%APPDATA%\pip\pip.ini属于用户级配置换项目不用重设。trusted-host是给 http 源用的https 源一般不需要但填了不会出错。config list能直接看到当前生效的键值比翻文件快。配置完拿一个小包试一下python -m pip install requests能在一二十秒内完成就算通了。3. 装 PyCharm2021.2.1 向导四个勾选项与首次启动的授权页Python 装好只是有了引擎日常写代码还得有个能跳转、能调试、能看变量值的编辑器。PyCharm 的安装本身比 Python 还简单向导一路 Next 就完事麻烦的是两个地方一是选哪个版本二是首次启动卡在授权页。3.1 Community 还是 Professional先看你要不要数据库和 Web 框架下载页上并排放着两个版本很多人不看说明直接点第一个装完发现要么功能不够用要么根本用不上那些功能。差别大致是这些能力Community 社区版Professional 专业版Python 编辑、调试、重构有有虚拟环境管理有有Web 框架支持模板、路由跳转无有内置数据库工具无有远程解释器、科学计算模式无有授权免费需授权判断标准很直接只写脚本、跑课设、刷算法题、做数据处理社区版完全够用而且不用管任何授权问题装完就能干活。要做 Web 项目、要连数据库、或者需要远程解释器才轮到专业版。版本号上原笔记用的是 2021.2.1。这个版本的安装向导和后续版本差别不大但首次启动界面有变化新版会先弹账号登录引导老版是直接进授权方式选择页。手上笔记写的是哪一版就按哪一版的界面去找对应入口别拿着新版的截图去老版里找按钮。下载页选 Windows 的 exe 安装包不要选 zip 免安装版免安装版不会注册开始菜单和文件关联后面每次启动都得去翻目录。3.2 安装向导里那四个勾选项双击安装包一路 Next 到 Installation Options 页这里四个复选框Create Desktop Shortcut勾64-bit launcher桌面留个入口Update PATH variable (restart needed)勾把 PyCharm 的 bin 目录追加到 PATH之后命令行敲pycharm能直接拉起Create associations勾.py 文件双击默认用 PyCharm 打开Add Open Folder as Project勾右键任意文件夹能直接「以项目打开」临时看别人的代码很方便第三个勾有点争议机器上如果还装着别的编辑器.py 关联被抢走会烦一阵但只用这一个 IDE 的话勾上更省事后面想改回右键「打开方式」里设置一下就行。安装路径保持默认即可PyCharm 自己处理带空格的路径没有问题不需要特意搬到 D 盘根目录。反过来把 IDE 装进一个中文命名的文件夹才是自找麻烦插件和索引偶尔会因为路径编码出状况。3.3 首次启动导入设置、主题、授权页第一次启动会先问 Import Settings新机器上没有可导入的配置选 Do not import settings 直接跳过。接着选主题Darcula 深色、Light 浅色随喜好后面在 Settings → Appearance 里随时能换。再往后是插件推荐页可以整页 Skip常用的插件等环境跑通了再按需装一次性装十几个插件是启动变慢的常见原因。然后是授权页。原笔记给的路径是 License server 方式启动界面里选 Activate PyCharm激活方式选 License server地址栏填入http://idea.higherbros.com点 Activate。这条路的现实情况得说清楚这类授权服务器地址的可用性不由使用者控制存活周期不固定。填进去点 Activate顺利的话一两秒就过如果一直转圈最后报错或者今天过了明天打开又变回未授权那就是地址失效了。所以不要把整个工作流绑定在这一个地址上——赶作业、赶交付的时候最怕的就是打开 IDE 发现进不去而项目代码本身一点问题都没有。替代方案的优先级我会这么排社区版最稳砍掉的那部分功能对纯 Python 脚本没有影响且永久免费、不用管授权官方试用 30 天功能全开适合短期评估专业版值不值在校学生和开源项目维护者可以走官方渠道申请对应授权。如果长期天天用专业版直接走正版最省心把每年折腾授权的时间折算一下这笔账不亏。授权过了之后PyCharm 会问要不要装 Vim 插件、要不要发送使用统计随意选都不影响后续。顺带记一下两个目录出玄学问题时用得上配置在%APPDATA%下以 PyCharm 版本号命名的文件夹里缓存和索引在%LOCALAPPDATA%下。打开卡死、索引崩了、插件装坏导致进不去界面时先关掉 IDE把缓存和索引目录删掉再启动让它自动重建比重装整个 IDE 快得多。配置目录别乱删解释器绑定、快捷键、插件列表都在里面。4. 配置解释器把项目和 C:\Python39\python.exe 固定绑定装完两个软件环境其实还是散的PyCharm 不知道你的 Python 装在哪Python 也不知道有这个项目。这一步就是把两边接上接错了后面所有报错都是它的连锁反应。4.1 新建项目时的三个字段从启动页点 New Project界面上真正要填的只有三块Location项目路径同样避开中文和空格比如D:\work\demo01解释器类型New environment using / Previously configured interpreterBase interpreter指向C:\Python39\python.exe推荐做法是选 New environment using类型保持 VirtualenvLocation 默认会填成项目下的.venvBase interpreter 下拉里选C:\Python39\python.exe。这样项目自带一个独立环境后面装什么包都关在自己的目录里。如果只是想临时跑个脚本、不打算装第三方库选 Previously configured interpreter点右边的...进 Add Interpreter → System Interpreter直接选C:\Python39\python.exe。判断标准一句话这个项目以后要装第三方包吗要装就 venv不装就系统解释器。判断错了也不致命后面在 Settings 里改解释器只要十几秒。4.2 项目里为什么还要套一层 venvvenv 是项目目录下一个独立的小 Python 环境它基于基础解释器创建但site-packages是自己的。项目 A 要 requests 2.25项目 B 要 requests 2.31如果都装在系统目录里最后只能留一个另一个项目必然出错而报错信息通常长得完全不像版本问题。venv 把这件事按项目隔开每个项目各装各的。PyCharm 识别 venv 的方式很简单项目下的.venv\Scripts\python.exe。它一旦存在项目就是独立环境。命令行里想手动操作这个环境先激活# 进入项目目录后激活虚拟环境 .\.venv\Scripts\Activate.ps1 # 若报「无法加载文件因为在此系统上禁止运行脚本」执行一次这句 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned # 激活后提示符前面会出现 (.venv)用这句做最终确认 python -c import sys; print(sys.executable)Activate.ps1是给 PowerShell 用的cmd 里换成activate.bat。执行策略那条只改当前用户不需要管理员权限改完对其它脚本的影响也很有限属于可接受的操作。最后那句sys.executable是最可靠的确认方式比看提示符靠得住——提示符可以骗人路径不会。这里有个坑值得单独拎出来venv 目录不能挪。整个项目文件夹从 D 盘拷到 E 盘或者发给同学.venv里的 python.exe 记录的是创建时的绝对路径一挪就失效PyCharm 会提示解释器无效。遇到这种情况别修删掉.venv重建一遍两分钟的事。4.3 装包、看包、固化依赖装包有三条路效果一样看场景选Settings → Project → Python Interpreter点号搜索安装适合一次性装一两个包底部 Terminal会自动激活 venv敲 pip 命令适合批量装外部命令行适合写脚本自动化# 在已激活 venv 的终端里装包 python -m pip install requests # 把当前环境的全部依赖连版本号导出给别人还原用 python -m pip freeze requirements.txt # 别人拿到项目后一行还原环境 python -m pip install -r requirements.txtfreeze会把当前环境里所有包连同间接依赖一起写进文件版本锁得死还原出来的环境最接近原样代价是文件比较长只想要清爽的直接依赖清单就手写 requirements.txt把 requests 这种直接用的列上间接的让 pip 自己解。两种做法都对团队里统一一种就行。还有个容易忽略的点PyCharm 底部 Terminal 默认会在项目根目录启动并自动激活 venv前提是 Settings → Tools → Terminal 里的 Activate virtualenv 勾着。如果发现 pip 装完在项目里 import 不到第一件事就是在那个 Terminal 里执行python -c import sys; print(sys.executable)看看是不是.venv里的那个。装到系统 Python 里去了是这类问题最常见的成因占到我在实际中遇到的八成。Settings → Project → Python Interpreter 页面会列出当前解释器下所有包和版本路径可以点开。装完包刷新一下列表看到新包出现说明这一环通了。5. 常见问题排查这五处出错最容易被误判成「装坏了」环境配完跑不起来八成不是软件坏了而是某个环节的路径断了。下面五条按出现频率排每条都按「现象 → 原因 → 解决」写清楚遇到时对号入座就行。5.1 敲 python 弹出应用商店现象cmd 里输入 python 回车浏览器跳到应用商店的 Python 页面或者弹出「未找到 Python请前往商店安装」的提示。原因Windows 的应用执行别名机制。系统在 PATH 里预置了两个占位 exe指向商店真 Python 没进 PATH 时命令被这个别名先接管于是打开的是商店而不是解释器。解决设置 → 应用 → 高级应用设置 → 应用执行别名把 python.exe 和 python3.exe 两个开关关掉同时确认C:\Python39\和C:\Python39\Scripts\都在 PATH 里。两件事做完重开命令行窗口再用where.exe python确认命中的是真解释器。5.2 python 不是内部或外部命令现象命令行提示「python 不是内部或外部命令也不是可运行的程序或批处理文件」但开始菜单里明明有 Python 的快捷方式。原因安装时 Add Python to PATH 没勾或者勾了但装成了 all users 模式路径写进了系统变量而当前账户读不到。快捷方式能启动是因为它写死了绝对路径和 PATH 无关。解决sysdm.cpl→ 环境变量 → 用户变量 Path 里补上C:\Python39\和C:\Python39\Scripts\两条保存后重开窗口。验证时不要只看python --version用where.exe python看完整路径输出为空说明 PATH 还是没生效。5.3 PyCharm 提示解释器无效项目里 import 全红现象项目打开后满屏红色波浪线右下角显示No interpreter或者之前一直能跑换机器、挪目录之后报 Invalid Python interpreter。原因解释器路径是以绝对路径写死在项目配置里的。venv 被删、项目文件夹被移动、Python 重装换了安装路径这几种操作都会让记录失效。解决Settings → Project → Python Interpreter → 齿轮图标 → Add重新指到C:\Python39\python.exe或项目下的.venv\Scripts\python.exe。如果是挪过项目导致的直接把.venv删掉按第 4 章的方式重建一个比修路径快。修完记得看一眼包列表包全丢说明指到了新环境得重新pip install -r requirements.txt。5.4 pip install 卡住、超时或报 SSL 证书错误现象pip install 停在 Collecting 半天不动最后Read timed out或者直接抛SSLError、certificate verify failed。原因三种可能。默认索引源在境外链路本身慢所在网络做了证书拦截pip 拿到的证书对不上系统时间偏差太大证书校验直接失败。解决先看系统时间差超过几分钟就同步一下这条最容易被忽略。时间没问题就换索引源用第 2.3 节的pip config set一次配好。仍然报 SSL 的用python -m pip install --cert 企业根证书路径指定证书或者对 http 源加--trusted-host。不要随手-i到来源不明的地址上装包这件事绕开可信来源省下的时间后面排查起来成倍还回去。5.5 授权页填了地址没反应或过几天又变回未授权现象License server 那一栏填完点 Activate一直转圈最后弹错误或者当天激活成功隔几天再打开 IDE 又回到未授权状态。原因这类授权服务器地址的可用性不由使用者控制可能限流、可能下线、也可能只是临时不可达。IDE 在启动时重新校验校验不通就回退。解决先用社区版把手上活干完社区版和已建好的项目、虚拟环境完全兼容不需要重新配环境再从官方试用、教育授权渠道里挑一条长期方案。切换版本时不用重装%APPDATA%下的配置目录保留着解释器和快捷键都在换个版本号启动就接着用。6. 装完怎么验证跑通五分钟走一遍最小闭环到这儿 Python 和 PyCharm 都装完了但「装完」和「能跑」是两件事。我习惯用一条最小链路验一遍五项全绿才算交付。验证项命令 / 操作期望结果命令行解释器where.exe python输出C:\Python39\python.exe版本python --versionPython 3.9.5pip 归属python -m pip --version路径在C:\Python39\Lib\site-packagesIDE 绑定的解释器Settings → Project → Python Interpreter显示.venv或C:\Python39\python.exe三方包可导入python -m pip install requests后运行下面的脚本无报错打印版本号在项目里新建一个hello.py把这段贴进去# 一次验证解释器、编码、三方包三件事 import sys import platform print(解释器路径:, sys.executable) # 最硬的证据到底用的哪个 python print(版本:, platform.python_version()) # 比 sys.version 干净只有版本号 print(默认编码:, sys.getdefaultencoding()) # 中文乱码时第一个要看的值 try: import requests print(requests:, requests.__version__) # 三方包能导入说明 site-packages 对 except ImportError: print(requests 没装上回到 4.3 走一遍)sys.executable那一行是整段里最有诊断价值的它直接打印当前进程用的解释器绝对路径和 Settings 页面里显示的那行对一下对不上就是绑错了其他都不用看了。getdefaultencoding()平时都是 utf-8一旦出现别的值多半是被某个环境变量改了中文报错会从这里冒出来。然后在 PyCharm 里右键 Run。Run 窗口的第一行会打印 PyCharm 实际执行的启动命令里面带着解释器路径比如C:\...\.venv\Scripts\python.exe。把这一行和 Settings 里显示的对照也和命令行where.exe python的结果对照三处一致环境就是通的。从那以后我每次配完机器都会把 hello.py 跑一遍再交付不看提示符、不看设置页只认sys.executable打出来的那一行路径。路径对得上后面九成所谓的玄学报错根本不会发生。希望帮到你。本文还有配套的精品资源点击获取