我一个朋友上周问我为什么教程里用的是 PyCharm 2020.3.2而他自己装的是最新版界面完全对不上这个问题太典型了。很多 2020 到 2021 年录制的课程、学校实验手册、论坛图文教程用的都是 PyCharm 2020.3.2 社区版。这个版本在当年的教学场景里普及度很高但如果你拿新版界面去对照旧教程操作很容易找不到按钮连新建项目的选项位置都不一样。所以这篇教程就专治这个问题。我会完整讲清楚这个版本到底适合什么环境、从哪个官方渠道下载、Windows 安装时哪些选项要勾、装完之后怎么把 Python 解释器配好、怎么写第一个程序并调试以及遇到诸如 “Microsoft Visual C 14.0 is required” 这类报错该怎么处理。全程基于官方渠道和免费社区版不需要任何来路不明的授权工具学 Python 基础、写 pandas 数据清洗、做 Flask 入门这个版本完全够用。1. 下载前必须想清楚的几个版本问题1.1 这个版本到底特殊在哪PyCharm 2020.3.2 发布于 2021 年 1 月属于 2020.3 系列的补丁版本。它在教学圈受欢迎不是因为功能有多新而是因为大量课程视频、实验教材正好拍摄于那个时段界面布局、默认配置都和后来的版本有明显差异。2020.3 系列处在 JetBrains 界面风格相对稳定的阶段没有老机器跑不动的大改动也没有后来版本里默认开启的新 UI整体体验非常“朴素直接”。另外要留意一类现实问题2020.3.2 的插件生态停在老时代现在很多 AI 辅助插件、远程协作插件要求 2023 年之后的 PyCharm 版本老版本装不上或装了也运行不稳定。如果你付费买课的核心卖点是那些新插件就不建议装这个老版本。反之如果你手头的课件、书本都是基于 2020.3.2 截图写的那按这个版本装准没错。1.2 社区版和专业版差在哪你该选哪个直接给结论学习阶段社区版完全够用。社区版是 JetBrains 官方推出的免费版本基于开源许可证发布包含编辑器、代码提示、调试器、版本控制集成、单元测试这些最核心的功能。专业版收费额外提供 Web 框架支持、数据库工具、远程解释器、科学计算模式等但这些东西对刚入门的人来说影响很小。如果你以后真的需要专业版功能也请走官方渠道学生朋友可以留意 JetBrains 官方的免费教育授权计划。但到目前为止请相信这句话学习 Python 语法、做小项目练手社区版和专版在基础体验上没有区别不用在这件事上多花一分钱。1.3 这个版本对 Python 版本的兼容边界2020.3.2 对 Python 3.6 到 3.9 的支持比较完善它发布的时候 Python 3.9 还是较新的稳定版。如果你的电脑上装的是 Python 3.10 或更高版本PyCharm 2020.3.2 不一定完全认识但多数情况下用来运行基础脚本、安装常见第三方库依然没问题只是代码补全和类型检查的准确度会略逊于新版本。我的建议是如果你只是跟着老教程做作业最稳的组合就是 2020.3.2 配 Python 3.9如果你打算长期学新语法特性或者项目里已经强制用了 Python 3.12那还是老老实实用新版 PyCharm。版本匹配不是玄学提前想清楚能省掉后面一大堆莫名其妙的小问题。2. 从官方渠道拿到安装包别被第三方带偏2.1 官网历史版本入口在哪打开浏览器访问 JetBrains 官方历史版本页面https://www.jetbrains.com/pycharm/download/other.html。页面上会列出 PyCharm 所有历史版本找到 2020.3.2 那一行按你的操作系统点 Windows、macOS 或 Linux 下载即可。如果网页加载太慢也可以直接用官网 CDN 固定链接下载Windows 版对应的是https://download.jetbrains.com/python/pycharm-community-2020.3.2.exemacOS 版把文件后缀换成.dmgLinux 版是.tar.gz。这个链接是 JetBrains 自己的下载服务器不是第三方网盘安全性有保障。2.2 安装包文件名怎么辨认真伪Windows 安装包大概 200 多 MB文件名里必须带community字样比如pycharm-community-2020.3.2.exe。如果没有community那说明是专业版安装包专业版是收费软件不是我们这篇教程的目标。我还想提醒一句不要从任何论坛、网盘、资源分享群里去下载所谓“社区版”压缩包。社区版本身就完全免费官网没有任何理由用压缩包形式分发。那些需要你注册、签到、关注公众号才能拿到链接的渠道要么是捆绑广告要么是修改过的安装包风险不可控。2.3 为什么我坚持让你走官方渠道一个很现实的原因社区版免费任何要求你付费解锁、安装额外授权工具才能用的网站都是在骗你。网上一搜“PyCharm 2020.3.2”搜索结果里经常混着大量“完整破解版”“永久授权”之类的链接点进去之后下载到的基本都不是官方原版有的还会附带木马、广告插件、篡改浏览器主页。这个版本在官方下载后直接安装就能用根本不存在需要授权码或授权工具的步骤。如果你看到某个教程让你去运行额外的工具来“解锁功能”立刻关掉那个页面它针对的是收费专业版的灰色手段对初学阶段毫无必要反而可能给电脑带来真实的安全风险。2.4 下载前先确认的三件事第一系统位数。现在绝大多数电脑都是 64 位系统Win11、Win10 基本都是影响不大但老电脑还是看一眼系统信息确认一下。第二磁盘空间。安装包和程序本体加起来占用 1GB 左右留够空间别装到一半卡住。第三最重要的电脑里是否已经安装了 Python。这里我建议你先装好 Python 再装 PyCharm。去python.org下载 Python 3.9 稳定版或者直接安装 Anaconda二选一。PyCharm 本身只是一个编辑器加 IDE它需要依赖外部 Python 解释器来真正执行代码没有解释器PyCharm 就像一个装了高档厨房工具却不通燃气灶的厨房菜单再漂亮也做不了饭。这个逻辑后面第 4 章会详细展开。3. Windows 安装全程拆解这些选项别乱勾3.1 安装向导逐步走一遍双击pycharm-community-2020.3.2.exeWindows 弹出用户账户控制UAC提示时选“是”。进入安装向导后第一步选择安装路径直接用默认的C:\Program Files\JetBrains\PyCharm Community Edition 2020.3.2就好不建议改成中文目录或者带空格的奇怪路径避免后续一些工具链指令识别出问题。下一步是Installation Options这里有几个勾选项我的建议是只勾必须的别让系统多出一堆以后用不到的入口Add launchers dir to the PATH建议勾选。它会把 JetBrains 的启动目录加入系统环境变量以后在命令行里调用相关命令比较方便副作用很小。Update context menu可勾可不勾。勾选后右键文件夹会出现“Open Folder as PyCharm Project”的入口。我个人习惯不勾因为右键菜单太乱会干扰日常操作。Create Associations不建议勾。如果勾上以后双击.py文件会直接用 PyCharm 打开新手很容易在外面误触导致环境错乱等你熟练了再手动用“Open with”选择打开方式也一样。点击 Install 后等待进度条跑完。最后一步可能提示重启系统如果你电脑里已经装过 Visual C 运行库、Python 等常用组件不重启也通常能正常运行但为了保险起见我建议直接重启一次避免后续出现“环境变量改了却没生效”的玄学问题。3.2 macOS 和 Linux 的安装注意点macOS 版是一个.dmg镜像文件双击后把 PyCharm 图标拖进 Applications 文件夹即可。如果系统提示“无法验证开发者”或“文件已损坏”先检查是不是下载过程中断了网络不稳容易导致 dmg 文件不完整重新下载一次通常能解决。Linux 版是tar.gz压缩包解压后进入pycharm-community-2020.3.2/bin目录执行./pycharm.sh就能启动。为了方便可以在桌面环境里手动创建快捷方式或者做一个软链接到/usr/local/bin但这些都属于锦上添花不影响程序本身使用。Linux 用户还需要确保系统里有图形界面库纯服务器无桌面环境是跑不了 IDE 的。3.3 第一次打开该选什么首次启动通常会遇到两个选择框一个是导入设置选Do not import settings即可另一个是隐私统计是否发送匿名使用数据按个人偏好选择。之后进入欢迎页面到这里安装阶段就结束了。欢迎页面左侧有New Project、Open、Get from VCS等入口不用急着点。下一节我们先把解释器这个关键问题搞定不然你新建了项目也运行不了。4. 首次启动先别急着写代码解释器配置是头等大事4.1 解释器为什么必须配很多新手第一次运行脚本就报No Python interpreter configured原因就是创建项目时没有选好解释器。PyCharm 作为一个 IDE自身并不内置 Python 运行时。它需要知道“用电脑里的哪一个 Python 来解释执行你的代码”这条路径就叫解释器。你可以把 PyCharm 理解成一家高档餐厅的后厨桌子、菜单、厨师服都备好了但灶台还没接上燃气。解释器就是那根燃气管不接上后厨再漂亮也炒不出一盘菜。所以这一步不是可选项而是刚需。4.2 在新建项目时配置解释器的三种路径在欢迎页点击New Project后弹出的窗口里有一个Base interpreter选项默认状态是Virtualenv Environment。如果下拉框已经自动识别出你安装的 Python直接选中即可如果下拉框是空的说明 PyCharm 没有自动找到 Python需要点击右边的...手动指定python.exe的路径。我推荐三种配置方式你可以按自己的实际情况选配置方式适合人群优点缺点System Interpreter系统解释器只装了 python.org 的 Python不折腾环境简单直接装完就能用包装多了系统 Python 环境会越来越乱Virtualenv Environment虚拟环境想隔离项目依赖避免包冲突每个项目独立一套包最规范每个项目都要重新安装第三方库Conda EnvironmentConda 环境装了 Anaconda偏数据科学方向科学计算包安装方便环境管理成熟Anaconda 体积大启动稍慢选好后点击CreatePyCharm 会创建项目并初始化解释器。如果项目创建成功左下角的状态栏一般会显示当前使用的 Python 版本这就是配置成功的信号。4.3 Anaconda 用户的特别提醒热词里搜索“pycharm配置anaconda”的人特别多我在这里多说两句。Anaconda 装完之后它的 Python 解释器路径通常长这样Windows 是C:\Users\你的用户名\anaconda3\python.exemacOS 是/Users/你的用户名/anaconda3/bin/pythonLinux 是/home/你的用户名/anaconda3/bin/python。如果你在 PyCharm 的Conda Environment里没有自动识别到 conda不要手敲路径先在 Anaconda Prompt 或系统终端里执行conda info或直接运行where python查看真实路径再把路径填回 PyCharm。我见过很多人因为手输路径时把用户名打错折腾半天才发现是路径写错了这种低级错误完全可以避免。4.4 解释器配置失败的常见坑第一个坑Python 明明装了但 PyCharm 识别不到。通常是因为 Python 安装时没有勾选Add Python to PATH。最简单的处理方式不是去手动修改环境变量而是在解释器设置里直接点击...手动选择python.exe的实际路径绕开 PATH 识别问题。第二个坑新建虚拟环境时进度卡住。这通常是网络问题PyCharm 在创建 venv 时会尝试下载pip和setuptools网络不稳定就容易卡住。这时候要么检查网络要么直接改用系统解释器或Existing environment等网络稳定后再回来重建虚拟环境。第三个坑项目已经建好了才想起来没配解释器。不要慌进入File - Settings - Project: 你的项目名 - Python Interpreter点右上角齿轮选择Add按上面三种方式重新配置即可。配置完成后打开底部任意一个终端窗口输入python --version能打印版本号就说明一切正常。5. 建项目、写代码、跑起来第一遍完整操作5.1 新建项目后的目录结构长什么样假设你新建了一个项目叫helloPyCharm 会生成一个以hello命名的目录。目录里通常包含一个.idea文件夹负责存 IDE 的项目配置、一个.venv虚拟环境目录如果你选择了虚拟环境以及你后续手动创建的.py源文件。.idea文件夹里的内容不要手动去改它是 IDE 用来记忆视图状态、运行配置、代码检查规则的。如果未来某天项目打不开或者 PyCharm 行为异常可以先把.idea删除再重新打开让 IDE 重新生成一份配置但这属于急救手段正常使用时不要碰它。5.2 写一个能运行的最小脚本在项目树里右键选择New - Python File输入文件名hello然后在内输入三行最经典的代码print(hello, pycharm) print(解释器配置成功)写完保存右键编辑区选择Run hello或者直接按快捷键CtrlShiftF10下方Run窗口就会输出hello, pycharm和解释器配置成功两行内容。能正常打印出这两行说明你从安装到解释器配置的整条链路已经全部跑通。如果你发现右键菜单里没有Run选项先检查两个地方文件扩展名是不是.py以及解释器有没有配置成功。多数情况下就是这两件事之一出了问题。5.3 三个容易混淆的窗口先说清楚PyCharm 底部工具栏里通常有三个面板新手特别容易搞混Run显示当前脚本运行的标准输出窗口。程序里的print内容都会出现在这里如果代码里有input()也在这个窗口输入数据。Terminal系统命令终端默认打开到项目根目录。安装第三方库、执行git命令都在这里操作PyCharm 会自动进入当前项目的虚拟环境。Python Console交互式 Python 解释器适合测试表达式、运行临时代码片段。它不会直接执行你当前编辑的.py文件只有在里面输入import或一行一行敲 Python 语句时才生效。很多人在Python Console里输入python hello.py发现没反应是因为交互式解释器里不接受 shell 命令。分清这三个窗口的角色后面操作会顺手很多。5.4 断点调试先花十分钟学会后面省十倍时间当代码逻辑变复杂之后只靠print排 bug 会非常痛苦。PyCharm 的调试器是它最值得花时间学的基础功能。在代码行号左侧的灰色区域点一下会出现一个红色圆点这就是断点。接着点击编辑器右上角的绿色甲壳虫图标或按快捷键ShiftF9PyCharm 会以调试模式运行当前脚本。程序执行到断点处会暂停下来底部调试窗口会展示当前所有变量的值。此时按F8是单步跳过当前行按F7会进入函数内部逐行执行CtrlF8可以再添加或移除断点。调试器不是专家专属功能初学者也值得从第一个大作业开始就用起来。我个人的经验是一个断点加一个变量窗口往往比连续猜测十几次print位置更能快速定位问题。5.5 改了代码运行结果却没变怎么办这个问题在旧版本 PyCharm 里更常见。如果你修改了hello.py的内容但运行结果还是旧输出大概率是运行了错误的跳转配置。正确的做法是先确认当前编辑的文件在项目树里处于选中状态然后再右键选择Run 当前文件名。如果确认运行的确实是当前文件仍然出现旧结果可以试试File - Invalidate Caches / Restart选择Invalidate and Restart。这个操作会清理 IDE 缓存并重启大概率能解决“代码改了但运行结果没变”这类诡异问题。要注意失效缓存不会删除你的源码放一百个心。6. 安装扩展包、碰见 Visual C 报错这里都写明白了6.1 装包的正确姿势为什么大家都在 Terminal 里敲 pip install热词里搜索最多的就是“pycharm 怎么安装 pandas 包”。标准操作是在 PyCharm 底部打开Terminal输入pip install pandas等待 pip 下载并安装看到Successfully installed pandas-2.x.x之类的提示就说明装好了回到代码里import pandas就能正常使用。这里有个关键细节在 PyCharm 的Terminal里执行pip install安装目标是当前项目的虚拟环境在系统自带的 CMD 或 PowerShell 里执行安装目标则是系统 Python 环境。为了不让环境互相污染你只需要记住一个习惯——以后每次都在 PyCharm 自己的Terminal里操作它会自动进入当前项目的虚拟环境装出来的包只属于这个项目不会干扰其他项目。6.2 import 之前为什么要 installPython 新手最容易产生一个误解既然代码里写了import pandas那 Python 是不是应该自动把 pandas 下载下来不是。import负责“使用包”pip install负责“安装包”。两者互相独立少了后面这一步解释器就会在运行时报ModuleNotFoundError: No module named pandas。打个比方import相当于点菜pip install相当于把菜买回自家厨房。你想在家吃一道水煮鱼不能只跟服务员报菜名你得先把鱼、调料、配菜都买齐了才能真正开火。报错信息里的ModuleNotFoundError就是在告诉你菜还没买厨房里没有这个东西。6.3 Microsoft Visual C 14.0 is required 到底是什么情况Windows 上装着装着包突然报这个错是老版本 PyCharm 用户很容易撞上的问题。报错原文类似error: Microsoft Visual C 14.0 is required. Get it with Microsoft C Build Tools这个报错的触发原因是你正在通过 pip 安装一个包含 C/C 扩展的包而 PyPI 上没有与你当前 Python 版本完全匹配的预编译文件于是 pip 打算从源码现场编译。编译过程需要用到微软的 C 构建工具链系统里没有所以报错。网上很多回答会让你“换 pip 源”“指定低版本”或者“下载一个奇怪的 whl 文件”其实绕来绕去都不如直接把工具链装齐。去微软官网搜Visual Studio Build Tools下载安装器运行时勾选“使用 C 的桌面开发”工作负载等待安装完成重启电脑再回到 PyCharm 的Terminal重新执行pip install。这一套做下来绝大多数需要编译的包都能顺利装上。还有一个容易混淆的报错运行某些软件时提示缺少msvcp140.dll。这属于缺少 Visual C Redistributable 运行库而不是 Build Tools。解决办法是去微软官网搜Microsoft Visual C Redistributable下载对应的 x64 版本安装即可。这两类问题经常被混为一谈但本质不同修复工具也不一样。6.4 虚拟环境坏了怎么办如果你某次操作后发现在Terminal里输入python提示找不到解释器或者之前装好的包突然全部消失大概率是虚拟环境被误删或者路径变了。最直接的恢复方式是关闭 PyCharm进入项目目录把.venv文件夹删除然后重新打开项目在解释器设置里重新创建虚拟环境或重新指向系统 Python。删除.venv不会影响你的源代码文件那些代码都在项目的.py文件里。只是需要重新pip install一遍依赖包。如果你之前把依赖列表记录下来了恢复过程就会很快。我建议每个人在项目根目录维护一个requirements.txt把每次成功安装的包和版本写进去将来换电脑、重建环境一条pip install -r requirements.txt就能全部装回来。这是很多专业人士早就养成的习惯越早开始做越好。7. 把界面调顺手汉化、字体、编码与快捷键7.1 中文界面设置怎么做2020.3.2 不能通过一个按钮直接切换中文官方提供的是语言包插件。进入File - Settings - Plugins - Marketplace搜索Chinese找到Chinese (Simplified) Language Pack EAP点击Install安装完成后重启 IDE界面就会变成中文。这里有个常见问题插件搜索结果里可能显示版本兼容性提示但旧版本 PyCharm 下装 EAP 版本的中文包通常问题不大。汉化包是 JetBrains 官方推出的预览版个别菜单可能还是英文或者翻译不太完整这属于正常现象不影响使用。我的个人建议是如果你打算长期在开发这条路上走界面用英文更有利。技术文档、报错信息、Stack Overflow 答案基本都是英文长期面对英文界面能减少很多隔阂提问时也更容易准确描述问题。但如果刚入门且英语一般先用中文界面提高学习效率完全没问题后面再慢慢切换也来得及。7.2 字体、字号和编码调整老教程录屏里的字通常很小照着操作容易眼累。进入File - Settings - Editor - Font把Size调到 16 到 18Primary font换成Consolas或系统等宽字体代码的观感会立刻舒服很多。界面字体则可以在Appearance模块里改成微软雅黑中英文混排更顺眼。编码设置是另一个容易被忽略的坑。为了防止中文注释和字符串出现乱码进入File - Settings - Editor - File Encodings把Global Encoding、Project Encoding、Default encoding for properties files全部设成UTF-8。2020.3.2 默认通常就是 UTF-8但你从旧项目里拷贝代码或者别人发来 GBK 编码文件时这个设置可以帮你解决大部分乱码问题。7.3 新手先掌握这几个快捷键就够了快捷键不用一口气记很多先记最常用的几个时间久了就会形成肌肉记忆快捷键功能CtrlShiftF10运行当前文件ShiftF10运行最近运行过的配置CtrlD复制当前行Ctrl/注释或取消注释CtrlAltL格式化代码CtrlF当前文件搜索CtrlShiftF全局搜索CtrlZ / CtrlShiftZ撤销 / 重做F8 / F7调试时单步跳过 / 单步进入Ctrl空格代码补全macOS 用户把Ctrl换成Cmd就是对应的快捷键整体逻辑是一致的。初学者不用刻意背列表每天写代码时先用“运行当前文件”和“格式化代码”这两个后面自然熟悉。7.4 一个很实用的最终排查技巧如果你在 PyCharm 2020.3.2 里遇到界面卡死、右键菜单消失、代码提示突然不工作这类问题先不要急着卸载重装。执行File - Invalidate Caches / Restart选择Invalidate and Restart让 IDE 清掉缓存后自动重启。绝大多数界面异常问题都能通过这一步解决。如果还是不行再考虑备份项目后彻底卸载重装。但请记住你的代码文件都在项目目录下坏掉的只是 IDE 自身的配置和缓存卸载重装不会丢源码。装好之后重新配置一次解释器项目照样能跑起来。最后再分享一个个人习惯我每次帮同事解决 PyCharm 问题第一句话都是问“你的解释器选对没有”第二句问“你的包装到哪个环境里了”。十次有八次问题都出在这两件事上。如果你在 PyCharm 2020.3.2 的使用中卡住了也先排查这两点比自己重装软件有效得多。