简介面向Python初学者与刚接触JetBrains生态的开发者这份PDF教程围绕PyCharm的下载、安装与初始配置展开帮助读者在Windows、macOS、Linux三类系统上快速完成环境搭建并顺利进入项目开发。内容覆盖官网版本选择与安装包格式差异、各平台安装流程、首次启动时的主题与字体设置、Python解释器及虚拟环境配置也简要说明项目创建、代码编辑、断点调试与Git版本控制集成的使用入口。资源包仅含1个PDF文件大小约138KB篇幅精简、按步骤编排适合打印或离线查阅遇到安装卡点时也能快速定位对应环节。目前已有1775人学习可作为零基础入门PyCharm的轻量操作手册也可供转用PyCharm的开发者梳理配置思路。1. 装个软件而已为什么零基础的人第一步总是卡在这里我见过太多这样的开头想学 Python兴冲冲装完双击一个.py文件黑框一闪就没了或者压根不知道代码该写在哪儿只能对着一个空白记事本发呆。真正卡住你的不是语法而是「没有一个正经写代码的地方」。这份PyCharm 安装教程.pdf讲的就是这件事——PyCharm 是一款 Python 集成开发环境IDE把写代码、跑代码、找错误这三件事收进同一个窗口。它适合完全没碰过编程的人不用先背命令行不用先记快捷键装完就能跑出第一行属于自己的代码。下面按「它是什么、装之前准备什么、怎么装、第一个例子怎么跑」的顺序一步步带你走完。2. 先搞懂一个概念IDE 不是插件是给你配齐设备的厨房2.1 用记事本写代码和用 IDE 写代码差在哪先想象做饭这件事。出租屋的厨房只有一口电磁炉和一口锅菜得在桌角切切完没地方放油溅出来没有抽油烟机做完洗碗还得端到卫生间去。饭当然做得出来但每一步都在跟环境较劲真正花在「做菜」上的精力反而最少。IDE 就是那间设备齐全的厨房灶台、备菜台、抽油烟机、垃圾桶、洗碗机全在你伸手够得着的地方你只需要专心琢磨这道菜怎么做。写代码是一模一样的道理。记事本写 Python你得到的是纯白纸一张它不知道你在写什么语言也不知道你写对没写对。IDE 在你敲下第一个字母的时候就开始帮忙了语法高亮关键字、字符串、数字、注释用不同颜色区分代码结构一眼可见不用逐字去数哪里是字符串的边界。自动补全打pri会弹出print候选项敲回车就补全函数名长到二十个字母也不用背。实时检查少写一个冒号、括号没配对、变量名拼错一个字母编辑器里当场画波浪线不用等到运行时才看报错。举个特别典型的例子。Python 里写条件判断if age 18后面必须跟一个冒号。在记事本里忘了这个冒号编辑器一声不吭你保存、运行程序跑到这一行才抛出一个SyntaxError然后你回头一行行数看到底是第几行出的问题。而在 PyCharm 里你还没保存那一行就已经标红了鼠标悬上去直接告诉你「此处应有冒号」。这个差别每天写十次代码就是省下十次来回折腾。还有一个新手几乎必踩的坑Python 靠缩进划分代码块Tab 和空格混用会直接报错。记事本里这两种空白看起来几乎一样肉眼根本分不出来。IDE 会自动把缩进统一还会在缩进层级错误的时候提醒你。这类「看不见的坑」正是新手最容易翻车的地方工具帮你挡掉你才能把注意力放在逻辑本身。2.2 PyCharm 替你干的四件事写、调、测、管PyCharm 的功能列表看起来很长但拆开其实就四件事每一件都对应新手的一个真实痛点。第一件是「写」。除了前面说的补全和高亮它还有代码折叠、代码片段、自动格式化、代码跳转。代码跳转这一项值得单独说按住 CtrlmacOS 上是 Command点一下函数名直接跳到这个函数定义的地方再点返回键就回来。想象一下你接手一个几百行的文件想弄清楚某个函数到底干了什么没有这个功能就只能靠搜索关键词跳来跳去跳三次就忘了自己在找什么。第二件是「调」。也就是调试。新手最常用的排错手段是print大法——在可疑的地方插一堆打印语句跑一遍看输出再删掉再插新的。程序小的时候这招够用可一旦是个循环跑一百次、第 87 次结果不对的场景你就得想办法只让它在第 87 次打印。PyCharm 的断点让你在任意一行按一下程序跑到那儿就停住你可以看当时每个变量的值可以一步一步往下走看哪一步开始不对。这个功能用过一次就回不去了。第三件是「测」。单元测试可以直接在编辑器里跑哪个用例过了、哪个没过用颜色标得清清楚楚不用去终端里翻一大段输出。零基础阶段你未必马上用到但知道它在那儿以后写函数想验证一下「输入这个应该得到那个」就有地方去了。第四件是「管」。版本控制集成。Git、SVN 这类工具是管理代码版本的说人话就是「给代码拍快照随时能回到之前任何一个版本」。PyCharm 把这些操作做成了界面按钮哪些文件改了、改在哪一行侧边栏一目了然不用一上来就背一堆命令。对零基础的人来说先用图形界面建立「版本」这个概念比硬啃命令行友好得多。除此之外PyCharm 还有插件机制可以按需扩展。做 Web 开发可以装 Django、Flask、Pyramid 这类框架的插件写前端可以装支持 bootstrap、angular、react 的插件。你现阶段不用管这些知道它以后能长大就行。2.3 社区版和专业版零基础先装哪个PyCharm 有两个版本社区版和专业版。社区版可以免费用专业版是付费的一般会提供一段试用期。两者的核心编辑器、调试器、项目管理这些基础能力是一套的差别主要在专业版多了一些面向 Web 框架开发、数据库工具和远程开发的进阶功能。对零基础的人来说结论很简单先装社区版。你现在要做的事情是「把代码写出来、跑起来、看它错在哪」这些社区版全都覆盖。等你以后真的开始用某个 Web 框架做项目或者需要直接在 IDE 里连数据库看表再回头考虑专业版也不迟。一开始就纠结版本属于还没学会走路先研究跑鞋的碳板结构。提示下载页面上两个版本的入口挨得很近看清楚再点别顺手点了专业版试用到期后弹窗会让你以为软件坏了。3. 动手之前的三项确认系统、Python、安装包格式3.1 三个系统对应的安装包长得不一样PyCharm 支持 Windows、macOS、Linux 三个系统但每个系统的安装包格式和安装方式完全不同。这一步先对号入座后面就不会下错文件。下面这张表可以先存下来你的系统安装包格式装完怎么启动安装难度Windows.exe安装向导走完后从开始菜单或桌面快捷方式打开最简单一路点下一步macOS.dmg图标拖进「Applications」文件夹从启动台打开简单拖一下就完事Linux.tar.gz解压到指定目录终端里运行bin/pycharm.sh需要敲几条命令Windows 用户下载.exe双击之后会出现一个安装向导跟着点就行。macOS 用户下载.dmg双击打开会看到一个窗口里面是 PyCharm 图标和「Applications」文件夹的快捷方式把图标拖过去就完成了安装。Linux 用户下载的是.tar.gz压缩包没有安装向导需要自己解压、自己用脚本启动。这里有个新手常犯的错在下载页面上看到一堆文件随手点了第一个结果下成了另一个系统的版本双击打不开还以为是文件损坏。下载前先确认页面顶部选择的是你当前使用的操作系统再点下载按钮。3.2 顺序别搞反先有 Python再装 PyCharm这是整篇里最重要的一条顺序问题。PyCharm 本身不自带Python它只是一个写代码、发指令的地方真正执行代码的是你电脑上的 Python 解释器。打个比方PyCharm 是遥控器Python 是电视。你把遥控器买回家按半天没反应因为客厅里根本没有电视。所以正确顺序是先确认电脑上装了 Python再装 PyCharm最后在 PyCharm 里把这两者「连」起来这一步叫配置解释器第 4 章会讲。那怎么知道电脑上有没有 PythonmacOS 和大部分 Linux 发行版通常预装了 Python但版本可能偏旧Windows 一般需要自己装。如果你还不确定先按下一节的命令查一遍确认了再往下走。至于电脑配置PyCharm 属于比较「实在」的开发工具安装包不大但装完之后加上索引缓存会占一些磁盘空间。入门阶段建议系统盘至少留出几个 G 的余量内存 4 GB 以上用起来会比较顺。如果你的电脑已经卡到开个浏览器都费劲那先清理一下空间再装别让工具本身成为你放弃的理由。3.3 两条命令确认 Python 在不在打开你系统里的命令行工具Windows 是「命令提示符」或者 PowerShellmacOS 和 Linux 是「终端」。然后敲下面这两条命令里的第一条# 查询当前系统里的 Python 版本 python --version # 如果上面那条提示「找不到命令」换成这条再试 python3 --version--version这个参数的意思是「只告诉我版本号别启动交互环境」。如果 Python 装好了你会看到类似Python 3.11.4这样的一行输出数字部分不用和这里完全一致能看到Python 3.开头就说明没问题。为什么准备了第二条命令因为在 macOS 和部分 Linux 系统上python这个命令名可能指向旧版本或者干脆没有新版本统一叫python3。两条都试一下哪条有输出就以哪条为准。这个细节记一下后面在 PyCharm 里配解释器、在终端里装第三方库的时候python和python3的区别还会再冒出来一次。如果两条都提示找不到命令说明 Python 还没装或者装了但没加进系统的环境变量。这时候先去装 Python装的时候 Windows 安装界面底部有一个「Add Python to PATH」的勾选项务必勾上——这是无数人踩过的坑不勾的话命令行永远找不到 Python后面配解释器的时候也会各种别扭。再补一条查路径的命令以后排查问题很有用# Windows 用 wheremacOS / Linux 用 which作用是显示这个命令对应的程序装在哪 where python # Windows which python3 # macOS / Linux输出的那个路径就是解释器的位置记下来或者截图存着。等一下在 PyCharm 里配置解释器时如果自动检测没找到你就手动把这个路径填进去。4. 跟着做一遍Windows、macOS、Linux 的安装与首次配置4.1 Windows双击 .exe 之后的每一屏下载好.exe文件找到它双击。接下来会出现一个安装向导大概分这么几步欢迎界面直接点「Next」。选择安装位置默认路径一般能用。如果你要改注意路径里不要出现中文和空格——这是新手翻车高发区某些工具链处理不了带空格的路径会在你完全想不到的地方报错。安装选项这一屏选项最多值得停一下。建议勾上「创建桌面快捷方式」和「关联 .py 文件」。关联.py文件的意思是以后你双击一个 Python 脚本系统会自动用 PyCharm 打开它而不是弹一个黑框一闪而过。如果你已经装了别的编辑器并且想保留它的关联这一项可以不勾不影响 PyCharm 本身使用。选择开始菜单文件夹默认即可点「Install」。等待进度条走完这一屏通常还有个「Run PyCharm」的勾选框勾上点「Finish」软件会直接启动。整个过程不需要你做任何技术决策默认选项对新手是够用的。安装完成后第一次启动会慢一点属于正常现象耐心等它把索引建完。4.2 macOS把图标拖进去就完了macOS 的安装是三个系统里最省事的。双击下载好的.dmg文件会弹出一个窗口里面左边是 PyCharm 的图标右边是「Applications」文件夹的图标有时候是箭头指向。按住左边的图标拖到右边的文件夹上松手。等复制进度走完安装就结束了。然后打开「启动台」找到 PyCharm 的图标点开。第一次打开的时候系统可能会拦一下提示这个应用是从互联网下载的、无法验证开发者。这是 macOS 对非应用商店来源软件的统一处理方式不代表软件有问题。去「系统设置」里的「隐私与安全性」页面往下翻能找到刚才被拦下的那条记录点「仍要打开」之后就不会再拦了。有一点要注意从.dmg里拖进 Applications 之后那个.dmg文件就可以删掉了它只是个安装包。但别在拖拽完成之前就把.dmg弹出那样会中断复制。4.3 Linux解压 一条启动脚本Linux 上没有双击安装这回事需要手动解压再运行启动脚本。打开终端按顺序执行下面几条命令# 1. 在家目录下建一个专门放应用的文件夹-p 表示目录已存在也不报错 mkdir -p ~/apps # 2. 解压下载好的压缩包到刚才那个目录 # -z 表示按 gzip 格式解压-x 表示解包-v 显示过程-f 指定文件名-C 指定解压到哪 tar -zxvf pycharm-*.tar.gz -C ~/apps # 3. 进入解压出来的目录星号是通配符会自动匹配实际解压出的目录名 cd ~/apps/pycharm-*/ # 4. 运行启动脚本 ./bin/pycharm.sh第三条命令里的*是个通配符因为不同版本解压出来的目录名不完全一样用星号就不用去背具体的目录名。./表示「当前目录下的」bin是存放可执行文件的目录pycharm.sh是启动脚本。整条命令读作「执行当前目录下 bin 里的 pycharm.sh 脚本」。如果第四条命令报错说Permission denied意思是这个脚本没有执行权限补一条命令赋权再运行# 给启动脚本加上可执行权限x 就是加执行权限的意思 chmod x bin/pycharm.shLinux 用户还可以顺手做一个桌面启动项或者软链接以后不用每次都 cd 进目录再运行脚本。这属于锦上添花第一次安装先不折腾也行能启动就已经成功了。4.4 首次启动的配置向导三步点完三个系统装完之后第一次打开 PyCharm 都会进入一个配置向导。别被「配置」两个字吓到本质上就是三个选择题。第一步要不要导入之前的设置。如果你以前在这台电脑上装过 PyCharm 并且保存过配置可以导入第一次装就选不导入从头开始界面更干净。第二步选主题和字体。深色主题通常叫 Darcula和浅色主题二选一纯粹看个人喜好白色背景看久了眼睛累就选深色用久了随时能在设置里改。字体大小也是这一步顺手调的觉得字小就调大一号写代码的时候眼睛舒服比什么都重要。第三步配置 Python 解释器。这一步是真正的关键。PyCharm 会扫描你系统里已有的 Python列出来让你选。列表里可能出现系统自带的 Python也可能有你装过的 Anaconda。选一个版本号比较新的就行。如果你在这一步看到「新建虚拟环境」的选项建议勾上。虚拟环境说白了就是给这个项目单独准备一个工具箱这个项目装了哪些库全放在自己的箱子里不会污染系统里其他的 Python也不会和别的项目打架。新手最容易遇到的一类玄学问题就是「明明装了库为什么还提示找不到」十有八九是装到了另一个 Python 里——用虚拟环境就能把这个坑从源头堵住。箱子里出了问题删掉整个文件夹重来就行不用重装系统。4.5 第一个能跑的例子三行代码加一个断点配置完进入主界面接下来跑通第一个程序。步骤很固定点「新建项目」选一个存放代码的文件夹路径同样避开中文和空格。确认解释器那一栏选的是刚才配好的那个。在左侧项目树上右键选「新建」→「Python 文件」文件名起个hello回车。然后在新文件里写入下面的代码# hello.py name 新手 # 定义一个字符串变量后面用得上 # f-string 是 Python 里拼字符串的写法花括号里可以直接写变量名 print(f你好{name}这是我的第一个 PyCharm 程序) # 下面这段用来演示断点range(3) 会依次给出 0、1、2 三个数 for i in range(3): doubled i * 2 # 把当前这个数乘以 2 print(i, doubled) # 打印两个值中间用逗号隔开输出时会自动空一格写完之后在代码编辑区任意位置右键选「运行 hello」或者点右上角的绿色三角按钮。下方的运行窗口会输出四行内容第一行是打招呼后面三行是0 0、1 2、2 4。看到这个输出说明你的 PyCharm、Python 解释器、项目三者已经连通了。接下来试一下调试这是 PyCharm 最值钱的功能。在doubled i * 2这一行的行号右边空白处点一下会出现一个红点这就是断点。然后点右上角那个长得像小虫子的按钮调试运行。程序会停在红点那一行整行变成蓝色高亮下方会多出一个变量面板里面能看到此刻i的值是 0。按 F8 单步往下走一行doubled变成 0再按 F8print那一行执行完输出一行。继续按i变成 1再往下走doubled变成 2。这个小练习的意义在于你亲眼看到了程序「一步一步执行」的过程而不是一次性吐出结果。以后代码写错了你不再需要靠猜而是可以让程序停在任意一行看清楚每个变量的值。很多新手觉得调试是高级技能其实它比print大法更简单只是没人教过你怎么点。5. 新手最容易翻车的五个地方现象、原因、解决办法5.1 安装环节的三个坑坑一安装包双击了转一圈就没反应桌面上也找不到图标。现象是双击之后进度条闪一下然后什么都没有开始菜单里搜不到桌面上也没有快捷方式。原因通常有两个一是安装包下载不完整网络中断过二是安装选项里没勾「创建桌面快捷方式」软件其实装好了只是你没找到入口。解决办法先去开始菜单里搜索「PyCharm」能搜到就说明装成功了右键固定到任务栏即可搜不到就重新下载安装包下载时别中途暂停下完对一下文件大小和下载页上标注的是否一致。坑二macOS 上打开时提示「无法打开因为无法验证开发者」。现象是双击图标后弹一个警告框只有「移到废纸篓」和「取消」两个选项没有「打开」。原因是系统对非应用商店来源的软件做了统一拦截不代表软件本身有问题。解决办法不要点「移到废纸篓」点「取消」然后打开「系统设置」→「隐私与安全性」往下翻到安全性那一栏会看到刚才被拦截的记录点「仍要打开」再确认一次之后这个软件就被系统记住了。坑三Linux 下运行启动脚本提示Permission denied。现象是敲完./bin/pycharm.sh回车终端直接回一句「权限不够」。原因是 Linux 出于安全考虑新解压出来的脚本默认不带可执行权限。解决办法是补一条chmod x bin/pycharm.sh给它赋权再运行一次。如果还是不行检查一下解压路径是不是有中文或者奇怪的字符换个纯英文路径重新解压往往就好了。5.2 配置和运行阶段的三个坑坑四新建项目之后代码里所有的import都标红右下角提示没有解释器。现象是明明写的是标准库比如import random也照样标红鼠标悬上去提示找不到模块。原因是项目没有绑定 Python 解释器PyCharm 不知道去哪儿找这些模块。解决办法打开「设置」→「项目」→「Python 解释器」从下拉列表里选一个已有的解释器或者点添加按钮手动指定路径把第 3 章用where或which查到的那个路径填进去。选完之后等几秒让 PyCharm 重建索引红色波浪线会自动消失。坑五在终端里pip install装完了PyCharm 里还是提示找不到模块。现象是命令行里装得好好的回到编辑器里import照样报错。原因是你的电脑上不止一个 Python你装库用的是 APyCharm 用的是 B两个不是同一个。解决办法别在系统终端里装直接用 PyCharm 底部的「终端」面板那个终端默认激活的就是当前项目的解释器环境在里面执行安装命令装完就是对的。如果项目用了虚拟环境注意每次打开新项目都要确认一下底部终端前面带没带环境标识。6. 装好只是起点接下来四周该练什么软件装完、第一个程序跑通很多人到这儿就停住了因为不知道下一步该干什么。给你一条可以照着走的四周路线每一项都对应 PyCharm 里的一个具体功能别贪多一周啃一个就够周次练什么用 PyCharm 的哪个功能第一周变量、条件、循环、函数每天写五个小练习编辑器 运行按钮重点练自动补全和缩进第二周列表、字典、字符串处理断点调试遇到结果不对就先停住看变量第三周读写文件、处理简单的数据项目的目录结构学会分文件组织代码第四周把前几周的练习整理成一个项目版本控制面板学会提交和回退第一周千万别急着做项目。我见过太多人第一天就去找「新手练手项目」结果照着抄了三百行一行都看不懂最后得出「我不适合学编程」的结论。真实情况是基础语法没打牢抄得越多越挫败。第二周开始刻意用断点。这一周的目标不是写出多漂亮的代码而是养成一个习惯程序结果不符合预期时第一反应是打断点而不是到处加print。这个习惯一旦养成后面学任何语言都受用。第三周开始你会遇到「代码越来越长一个文件塞不下」的问题这时候再去学怎么分文件、怎么建文件夹动机是真实的学起来也记得住。PyCharm 的项目树就是为这个准备的右键新建、拖拽移动比在文件管理器里操作直观得多。第四周试着用一下版本控制面板。不用学命令行就在界面里点「提交」写一句这次改了什么确认。然后故意改坏一个文件再从历史记录里回滚回去。这个动作做一遍你就理解了「后悔药」是什么意思——以后改代码胆子会大很多因为知道随时能退回去。最后说个我自己的血泪经验。我第一次装完这类开发工具的时候觉得装好了就等于会用了结果后面每次遇到问题都怀疑是环境配错了来回重装了三遍浪费的时间够学完一整个基础教程。从那以后我每次装完新工具都强制先跑一个最小可运行的例子——就三行代码能打印出东西、能打断点停下——确认这条链路通了再去折腾别的东西。这个习惯帮我省掉了大量「到底是代码错了还是环境错了」的自我怀疑。这份 PyCharm 安装教程.pdf 把三个系统的步骤都整理在一起了卡住的时候翻一翻比自己在网上东拼西凑要快得多。希望帮到你。本文还有配套的精品资源点击获取