1. 安装之前先把这些问题想清楚1.1 版本选型为什么我推荐2019.3而不是最新版先说个有意思的事。直到今天还有不少人问我“博主2019年的东西了你还写它干嘛”这恰恰是我想写这篇教程的原因。我在几个编程交流群里观察过问“PyCharm怎么装”的新手里至少有三成还在各种渠道找旧版本安装包有的是课程讲义指定了版本有的是公司内网只推送了2019版的镜像还有相当一部分人手里的电脑配置确实跑不动最新版。PyCharm 2019.3作为2019年的收官版本在当年算是一个非常稳定的里程碑很多老项目的开发环境至今还锁在这个版本上所以这篇教程我决定以它为主线来讲但里面提到的思路和步骤放到2024、2025的新版本上一样适用。先说版本怎么选。PyCharm分为社区版Community和专业版Professional2019版也是如此。社区版免费、开源支持Python开发、代码调试、版本控制这些日常够用的功能专业版收费额外支持Django/Flask等Web框架的模板提示、数据库工具、远程解释器、科学计算工具等。对刚入门、只想把Python基础语法跑通的新手社区版完全够用没必要一开始就折腾专业版。对需要做Web开发、数据工程的老手专业版确实香但前提是得有正版授权这个我后面单独说。1.2 环境准备先把Python装好别跳过这一步很多新手安装PyCharm时最容易犯的错误是——直接装IDE完全不管Python解释器。等打开软件新建项目时才发现“No Python interpreter selected”然后一脸懵。PyCharm本质上是一个编辑器外壳真正执行你代码的是Python解释器这俩缺一不可。所以安装PyCharm之前请先确认你的电脑里已经装好了Python。2019.3版本官方推荐的配套是Python 3.7或3.8这两个版本在当时非常成熟第三方库兼容性也很好。你可以在命令行输入python --version检查是否已安装如果提示“不是内部或外部命令”说明还没装先去Python官网下载对应版本装好。Windows用户安装Python时务必勾选“Add Python to PATH”这个选项这是无数新手踩坑的重灾区——没勾选的话后面PyCharm找解释器时会遇到一堆莫名其妙的问题。操作系统方面Windows 7/10、macOS、Linux都有对应的2019.3安装包官方支持64位系统。硬件上PyCharm是基于Java开发的2019.3这个版本内存占用不算夸张但4GB内存确实会比较吃力建议至少8GB内存。如果你用的是只有4GB内存的老本子安装后建议把IDE的堆内存调小一点这个优化方法我在第5部分会讲到。1.3 关于激活我把话说在前面热搜词里“PyCharm激活”“破解版”的热度一直很高但我必须负责任地告诉各位如果你用的是社区版根本不需要激活下载安装完就能永久免费使用没有任何功能阉割到不能学Python的程度。如果你确实需要专业版的功能官方提供了30天全功能试用学生和教师凭校园邮箱还可以申请免费的教育授权这是完全合法的途径。为什么不建议用破解工具一是安全风险这类工具大概率捆绑木马或挖矿程序你为省几百块搭进去的可能是整个电脑的隐私和数据二是法律风险PyCharm在国内外的企业用户中普及率极高不少公司因此收到过JetBrains的律师函。我的建议是学习阶段老老实实用社区版等真做商业项目了按年订阅也就一千多块钱还能抵扣企业所得税。拿技术吃饭的人在这上面栽跟头不值得。下面所有安装步骤都是基于社区版演示的专业版的安装流程一模一样只是首次启动时需要登录账号激活。2. 下载与安装一步步完整实操2.1 从官网找对安装包避开捆绑下载站PyCharm的下载渠道请认准官方网站。这里多说一句搜索引擎里搜“PyCharm下载”首页往往会出现一堆下载站界面做得和官网很像但下载按钮点下去可能下载到的是病毒安装包、推广软件甚至是需要付费的假冒版本。认准官网两个特征域名是jetbrains.com结尾网页上有“Download”按钮不会有夸张的“高速下载”“立即下载”广告词。进入官网后点页面上的“Download”按钮会看到两个版本下载入口Community和Professional。我们下载“Community”下面的版本。这里有个小技巧官网默认提供的是当前最新版如果你确实需要2019.3这个历史版本可以点击页面下方的“Other versions”链接在历史版本列表里找到“2019.3.x”进行下载。Windows用户下载后缀为.exe的可执行文件macOS用户下载.dmg镜像文件Linux用户下载.tar.gz压缩包。顺带提醒一下2019.3版本的安装包大约230MB左右下载速度慢的话可以换网络环境试试但别去那种号称“高速下载”的第三方站点抢速度安全比效率重要。2.2 Windows安装全过程一路点Next的学问下载完安装包后双击.exe文件可能会弹出用户账户控制UAC的确认框点“是”。这时候能看到安装引导界面我逐个选项给你说清楚。第一步是选择安装路径默认是C:\Program Files\JetBrains\PyCharm Community Edition 2019.3。我的建议是改到D盘或其他非系统分区比如D:\PyCharm Community Edition 2019.3。原因是PyCharm会生成大量缓存和索引文件放系统盘容易导致C盘爆满而且重装系统时配置容易丢。第二步是安装选项设置这一步很关键64-bit launcher默认勾选会在桌面创建一个启动快捷方式建议保留。Add launchers dir to the PATH这个选项的作用是把PyCharm的启动命令加到系统环境变量里方便以后在命令行输入charm直接启动IDE。不建议勾选因为日常使用根本用不到这个命令加进去反而污染PATH。Create Associations关联.py文件格式建议全部勾选这样双击.py文件会直接用PyCharm打开。Create Desktop Shortcut同上勾上64位那个就行。接下来进入“Select Start Menu Folder”直接默认“Next”。最后会让你选择是否“Import PyCharm settings from”一个旧版本如果你是第一次安装选“Do not import settings”然后点击“Install”。整个安装过程根据电脑性能需要两三分钟到五六分钟不等安装完成后界面会出现两个勾选项Run PyCharm Community Edition立即运行和Create Desktop Shortcut创建桌面快捷方式。先不急着运行点“Finish”结束安装。2.3 macOS与Linux安装的差异说明如果你用的是macOS安装会简单得多。下载的.dmg文件双击打开后会弹出一个窗口里面有一个PyCharm的图标和一个“Applications”文件夹的快捷方式把PyCharm图标拖进“Applications”文件夹安装就算完成了。首次打开时macOS的Gatekeeper安全机制可能会拦截未识别开发者的应用你需要在“系统偏好设置-安全性与隐私-通用”里点击“仍要打开”。这里有个macOS特有的坑从网上下载的应用首次打开时会提示“PyCharm已损坏无法打开你应该将它移到废纸篓”。这个提示往往是因为安全策略导致的误报不是安装包真的损坏。解决方法是打开终端执行sudo xattr -dr com.apple.quarantine /Applications/PyCharm.app把隔离属性删掉然后重新打开就好了。Linux用户则相对省心解压.tar.gz后进入bin目录执行./pycharm.sh即可启动。3. 首次启动与项目创建实操3.1 首次启动设置主题、快捷键方案与插件安装完成后双击桌面的PyCharm图标首先看到的是“Complete Installation”界面继续选“Do not import settings”。点击“OK”后会弹出一个许可协议窗口社区版直接点“I confirm that I have read...”然后选“Evaluate for free”跳过登录即可不用输入任何邮箱密码。接下来是欢迎界面有两个设置需要你花十秒钟决定UI主题是亮色还是暗色IDE快捷键方案是默认的“Windows”还是“Mac OS X”。我的建议是主题选“Darcula”暗色写代码对眼睛友好这也是大部分程序员的选择快捷键方案建议不折腾用默认就行等以后熟练了再按自己习惯自定义。设置完主题后可以点右下角的“Skip Remaining and Set Defaults”跳过其他选项直接进入主界面。首次进入主界面后PyCharm会在后台自动扫描系统环境、构建索引右下角有个进度条在转这是正常的。请耐心等它扫描完再进行下一步操作否则容易出现编辑器卡顿、代码提示不灵敏的问题。扫描时间取决于你电脑里文件数量的多少一般几分钟内完成。3.2 新建项目第一次配置Python解释器在欢迎界面点击“Create New Project”进入“New Project”对话框。这一步是整个教程的重中之重因为PyCharm项目文件夹会自动生成一个叫.idea的目录专门存放IDE的配置信息。这些配置包括解释器路径、编码格式、运行配置等它们是PyCharm能正常识别你代码环境的关键。“New Project”对话框里有两块区域。上面是“Location”也就是项目存放路径建议放到一个单独的目录比如D:\PythonProjects\my_first_project别和PyCharm安装路径混在一起。下面是“Project Interpreter”配置区打开“Existing interpreter”旁边的下拉框如果没有可选解释器就点右边三个点的按钮在弹出的对话框里选择系统Python的安装路径比如C:\Python38\python.exe。这里我重点讲讲下拉框里出现的“Virtualenv”这个选项。PyCharm在创建新项目时默认会创建一个虚拟环境virtualenv这相当于给当前项目单独隔离出一个Python运行空间你在里面装的第三方包不会污染系统全局的Python环境。对于刚入门的同学我可以直接给你一个结论用默认的Virtualenv就好不要手动动它。虚拟环境听起来高大上但它解决的是“项目A需要pandas1.0项目B需要pandas1.5两边装了会打架”这类问题等你真正遇到这个冲突时自然就理解了现在不用给自己加负担。3.3 关联Anaconda/Conda环境如果你按照我前面说的安装了Anaconda来管理Python环境那这里的操作要稍微变一下。很多新手一上来就用Anaconda因为它自带了几百个常用科学计算库省去了一个个装包的麻烦。在“Project Interpreter”下拉框里如果你能看到与Conda相关的解释器选项直接选上即可如果没看到点右边三个点的按钮在弹出的“Add Python Interpreter”窗口里选“Conda Environment”——左侧选“Existing environment”右侧Interpreter路径定位到Anaconda安装目录下的python.exe比如D:\Anaconda3\python.exe。这里有个热词里高频出现的坑——pycharm conda路径。有不少人装完Anaconda后发现PyCharm里找不到Conda解释器或者路径明明是空的但PyCharm怎么都识别不了。我遇到过的情况是Anaconda被安装在带中文或空格的路径下例如D:\软件包\Anaconda3PyCharm的终端和解释器解析就会出现兼容问题。解决方法是把整个Anaconda安装到纯英文路径下比如D:\Anaconda3。这个问题困扰过好多网友你在搜索引擎里看到大量类似提问基本都是这个原因导致的。3.4 项目创建完成后的第一段代码配置完解释器、点“Create”创建项目后PyCharm会花几十秒初始化项目结构。初始化完成后的界面分三块左边是项目文件树中间是代码编辑区下边是终端和运行窗口。右键点击左侧项目根目录选择“New - Python File”起个文件名比如hello.py输入以下代码print(Hello, PyCharm!)然后右键点击代码区空白处选择“Run hello”或者直接按快捷键ShiftF10。如果一切顺利底部会弹出“Run”窗口显示Hello, PyCharm!到这里你的PyCharm就算真正会用了。如果运行时报错“No Python interpreter configured for the project”说明前面的解释器配置步骤出了问题回头重新检查第3.2节的操作。如果报错提示找不到python命令大概率是安装Python时没勾选“Add Python to PATH”需要手动把Python目录加到系统环境变量里或者重新运行Python安装程序勾选该项。4. 日常使用必会的几个实战配置4.1 设置中文界面装插件还是改语言包热搜词里“pycharm怎么设置中文”是高频问题。PyCharm 2019.3这代版本默认界面是英文的官方直到2021版本之后才开始官方内置中文语言包但2019版可以通过插件市场安装中文语言包来实现汉化操作路径很简单在PyCharm菜单栏依次打开“File - Settings - Plugins”在右侧输入框搜索“Chinese Language Pack”找到由JetBrains官方发布的简体中文语言包插件点击“Install”安装。安装完成后PyCharm会提示重启IDE重启后界面就变成中文了。注意下载这个插件需要能正常访问插件市场如果你的网络环境连不上可以通过国内源手动下载zip插件包再在Settings-Plugins里点齿轮图标选“Install Plugin from Disk”安装。不过我个人其实不太建议新手一上来就汉化。不是说汉化不好而是因为PyCharm的英文资料、教程、报错信息基本都是英文的早早习惯英文界面反而能帮你更快融入开发者的信息环境。我的建议折中一下第一次用先汉化跑通整个流程建立信心跑通之后再换回英文界面就当是练技术英语了。4.2 安装第三方包pandas、flask等的正确姿势“pycharm怎么安装pandas包”这类搜索热词背后是无数Python新手卡在了第三方库安装这一步。在我的经验里PyCharm安装第三方http包主要三种方式从稳妥到高效排序如下方式一Settings里可视化安装打开“File - Settings - Project - Project Interpreter”右侧能看到当前解释器已安装的包清单点右上角的“”号在搜索框里输入你想装的包名比如pandas下方会自动匹配版本点“Install Package”按钮底部会出现安装进度条。这种方式的优点是直观缺点是需要通过PyPI官方源下载国内网络环境下有时会非常慢甚至超时。方式二PyCharm终端里用pip安装在PyCharm底部找到“Terminal”标签打开终端输入pip install pandas回车等待安装完成。这个方式的本质和方式一相同都是调用pip工具但用命令行更灵活可以指定版本、指定镜像源。国内用户建议用清华镜像源加速pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple方式三直接使用项目虚拟环境里的python -m pip如果你用的是虚拟环境有时直接在Terminal里敲pip命令会指向全局Python的pip装到错误的地方导致PyCharm里依然“No module named pandas”。稳妥的写法是python -m pip install pandaspython -m pip确保使用当前激活的解释器对应的pip这个细节能帮你避开很多“明明装了却导入失败”的坑。4.3 高频快捷键提升编码效率的必备清单PyCharm的快捷键体系很丰富但对于新手我不建议你一开始就背厚厚的快捷键速查表。以下是我个人认为使用频率最高、最值得先记住的几个ShiftF10运行当前文件CtrlP查看某个函数的参数提示CtrlAltL一键格式化代码缩进、空格、换行自动规整CtrlD快速复制当前行到下一行CtrlShiftF10调试当前文件ShiftF9以调试模式运行Tab/ShiftTab缩进/取消缩进这些快捷键在写代码时几乎每分钟都会用到练熟之后编码速度提升立竿见影。尤其是CtrlAltL我强烈建议所有新手养成写几行代码就格式化一次的习惯代码整洁度直接影响以后协作时别人对你的第一印象。4.4 配置终端使用Conda环境如果你走的是Anaconda路线在PyCharm的Terminal里执行的conda命令可能会提示找不到这是因为Terminal默认使用的是系统自带的shell并没有激活Conda环境。解决方法有两种一是在“File - Settings - Tools - Terminal”里把Shell path改成Anaconda的cmd.exe二是每次打开终端后手动执行conda activate激活base环境。我自己更喜欢第二种毕竟手动激活能明确知道自己当前在哪个环境里心里踏实。5. 常见问题与排查技巧实录5.1 报错“Microsoft Visual C 14.0 is required”的解决这是搜索热词里非常典型的一个报错场景。你在安装某个第三方包常见于pandas、scipy、pycrypto等含有C扩展的包时pip突然抛出error: Microsoft Visual C 14.0 is required. Get it with Microsoft Visual C Build Tools核心原因在于这些Python包本身包含C/C源码在Windows上没有现成的whl包时pip会尝试在你本地编译源码而编译需要Microsoft Visual C编译器。2019年那会儿这话还没人信……不是这句话的意思是这个编译环境你得去微软官网下载“Microsoft Visual C Build Tools”安装包安装时勾选“Visual C 15/17/19”相关的编译组件。装好C编译工具后重新执行pip install命令绝大部分情况都能顺利装完。如果实在不想装编译环境还有另一条路去https://www.lfd.uci.edu/~gohlke/pythonlibs/下载对应Python版本和系统位数的预编译whl包然后执行pip install 下载的文件名.whl这个方法绕过了源码编译直接安装编译好的二进制文件速度还更快。5.2 报错“FileNotFoundError”的排查思路这也是热搜里的高频词。运行代码时提示FileNotFoundError多数情况下是文件路径写错了。这里要特别强调一个PyCharm新手最容易犯的错误PyCharm运行代码时的“当前工作目录”和Python文件所在的目录不一定相同。比如项目结构是D:\myproject\ ├── main.py └── data\ └── input.txt你在main.py里写open(data/input.txt)如果main.py在D:\myproject\下工作目录刚好是项目根目录那能正常运行。但如果你把main.py移到D:\myproject\src\下代码里还写open(data/input.txt)运行时就可能报FileNotFoundError因为现在的相对路径是相对于src目录的。排查方法很简单右键点击文件选择“Modify Run Configuration”在弹出的“Working directory”一栏里确认它指向的是你期望的工作目录。如果不对就改成项目根目录的绝对路径。想偷懒的话也可以用os.path.dirname(__file__)来动态获取当前文件所在目录拼出完整的绝对路径这样无论在哪运行都不会出问题。5.3 IDE卡顿、内存不足的优化PyCharm用久了卡顿几乎每个开发者都会遇到。2019.3版本在8GB内存的电脑上默认配置启动后内存占用就能到1GB以上加上索引构建、代码检查卡是正常的。这时候可以手动调整PyCharm的内存分配找到PyCharm安装目录下的bin文件夹里面有个pycharm64.exe.vmoptions文件用文本编辑器打开把-Xmx开头的参数改大比如-Xms512m -Xmx2048m-Xms是初始堆内存-Xmx是最大堆内存我把-Xmx从默认的1024m调到2048m明显能感觉到打开大文件、代码提示时的延迟降低了。但注意别盲目往大了调-Xmx超过你电脑物理内存的一半反而会因为频繁GC更卡。另外PyCharm的“File - Invalidate Caches and Restart”这个功能很实用——当你发现代码提示失灵、索引错乱、莫名卡顿时执行一次缓存失效并重启相当于给IDE做了个大扫除能解决七八成的“灵异问题”。5.4 常见问题速查表问题现象常见原因解决方案运行时报“No Python interpreter”新建项目时未正确选择解释器进入Settings-Project-Project Interpreter重新配置安装包报“Microsoft Visual C 14.0 is required”源码包需要本地编译安装Visual C Build Tools或下载预编译whl包终端执行conda提示找不到命令Conda环境未激活先conda activate再执行命令FileNotFoundError工作目录与相对路径不匹配检查运行配置的Working directory代码提示不出来索引未构建完成或缓存损坏等待索引完成或执行Invalidate Caches并重启插件市场打不开网络问题导致无法访问JetBrains插件仓库使用国内镜像源或离线下载zip插件包手动安装5.5 关于旧版本使用的一些额外提醒用2019.3这个版本还有一个比较特殊的问题它内置的Python解析引擎对f-string等较新语法支持得很好但对于Python 3.10及以上版本新增的语法特性比如match语句会报语法错误这是因为IDE的语法解析器没有跟着更新。如果你装了新版的Python解释器但代码一写到新语法就报红先查一下是不是PyCharm版本过老导致的解析问题别一股脑怪代码写错了。解决办法要么升级PyCharm版本要么在编写需要新语法的代码时切到新版IDE里写。另外PyCharm 2019.3的代码格式化风格、git集成界面、虚拟环境管理器跟后续版本在交互上有一些区别如果跟着新版教程操作发现界面对不上大概率是版本差异。判断方法很简单看界面上的菜单是不是英文、有没有某些新版才有的选项。我在实际使用中还有个心得按上面把2019版调到顺手之后尽量不要频繁更换大版本。JetBrains系IDE每次大版本升级索引重建、插件兼容、配置迁移都会消耗不少精力和时间对于正在学习阶段、以完成作业和练习为主的新手来说稳定压倒一切。等哪天你确实需要新版才能用的功能比如新语法支持、远程开发再考虑迁移也不迟。工具毕竟是工具能帮你把代码跑起来、把逻辑调通、把项目做出来它就算圆满完成任务了。