企业官网建设流程全解析

简介：面向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 的功能列表看起来很长，但拆开其实就四件事，每一件都对应新手的一个真实痛点。

第一件是「写」。除了前面说的补全和高亮，它还有代码折叠、代码片段、自动格式化、代码跳转。代码跳转这一项值得单独说：按住 Ctrl（macOS 上是 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，双击打开会看到一个窗口，里面是 PyCharm 图标和「Applications」文件夹的快捷方式，把图标拖过去就完成了安装。Linux 用户下载的是.tar.gz压缩包，没有安装向导，需要自己解压、自己用脚本启动。

这里有个新手常犯的错：在下载页面上看到一堆文件，随手点了第一个，结果下成了另一个系统的版本，双击打不开还以为是文件损坏。下载前先确认页面顶部选择的是你当前使用的操作系统，再点下载按钮。

3.2 顺序别搞反：先有 Python，再装 PyCharm

这是整篇里最重要的一条顺序问题。PyCharm 本身不自带Python，它只是一个写代码、发指令的地方，真正执行代码的是你电脑上的 Python 解释器。

打个比方：PyCharm 是遥控器，Python 是电视。你把遥控器买回家，按半天没反应，因为客厅里根本没有电视。所以正确顺序是：先确认电脑上装了 Python，再装 PyCharm，最后在 PyCharm 里把这两者「连」起来（这一步叫配置解释器，第 4 章会讲）。

那怎么知道电脑上有没有 Python？macOS 和大部分 Linux 发行版通常预装了 Python，但版本可能偏旧；Windows 一般需要自己装。如果你还不确定，先按下一节的命令查一遍，确认了再往下走。

至于电脑配置，PyCharm 属于比较「实在」的开发工具，安装包不大，但装完之后加上索引缓存会占一些磁盘空间。入门阶段建议系统盘至少留出几个 G 的余量，内存 4 GB 以上用起来会比较顺。如果你的电脑已经卡到开个浏览器都费劲，那先清理一下空间再装，别让工具本身成为你放弃的理由。

3.3 两条命令确认 Python 在不在

打开你系统里的命令行工具：Windows 是「命令提示符」或者 PowerShell，macOS 和 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 用 where，macOS / Linux 用 which，作用是显示这个命令对应的程序装在哪 where python # Windows which python3 # macOS / Linux

输出的那个路径就是解释器的位置，记下来或者截图存着。等一下在 PyCharm 里配置解释器时，如果自动检测没找到，你就手动把这个路径填进去。

4. 跟着做一遍：Windows、macOS、Linux 的安装与首次配置

4.1 Windows：双击 .exe 之后的每一屏

下载好.exe文件，找到它，双击。接下来会出现一个安装向导，大概分这么几步：

1. 欢迎界面：直接点「Next」。
2. 选择安装位置：默认路径一般能用。如果你要改，注意路径里不要出现中文和空格——这是新手翻车高发区，某些工具链处理不了带空格的路径，会在你完全想不到的地方报错。
3. 安装选项：这一屏选项最多，值得停一下。建议勾上「创建桌面快捷方式」和「关联 .py 文件」。关联.py文件的意思是，以后你双击一个 Python 脚本，系统会自动用 PyCharm 打开它，而不是弹一个黑框一闪而过。如果你已经装了别的编辑器并且想保留它的关联，这一项可以不勾，不影响 PyCharm 本身使用。
4. 选择开始菜单文件夹：默认即可，点「Install」。
5. 等待进度条走完：这一屏通常还有个「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.sh

Linux 用户还可以顺手做一个桌面启动项或者软链接，以后不用每次都 cd 进目录再运行脚本。这属于锦上添花，第一次安装先不折腾也行，能启动就已经成功了。

4.4 首次启动的配置向导：三步点完

三个系统装完之后，第一次打开 PyCharm 都会进入一个配置向导。别被「配置」两个字吓到，本质上就是三个选择题。

第一步，要不要导入之前的设置。如果你以前在这台电脑上装过 PyCharm 并且保存过配置，可以导入；第一次装就选不导入，从头开始，界面更干净。

第二步，选主题和字体。深色主题（通常叫 Darcula）和浅色主题二选一，纯粹看个人喜好，白色背景看久了眼睛累就选深色，用久了随时能在设置里改。字体大小也是这一步顺手调的，觉得字小就调大一号，写代码的时候眼睛舒服比什么都重要。

第三步，配置 Python 解释器。这一步是真正的关键。PyCharm 会扫描你系统里已有的 Python，列出来让你选。列表里可能出现系统自带的 Python，也可能有你装过的 Anaconda。选一个版本号比较新的就行。

如果你在这一步看到「新建虚拟环境」的选项，建议勾上。虚拟环境说白了就是给这个项目单独准备一个工具箱：这个项目装了哪些库，全放在自己的箱子里，不会污染系统里其他的 Python，也不会和别的项目打架。新手最容易遇到的一类玄学问题就是「明明装了库，为什么还提示找不到」，十有八九是装到了另一个 Python 里——用虚拟环境就能把这个坑从源头堵住。箱子里出了问题，删掉整个文件夹重来就行，不用重装系统。

4.5 第一个能跑的例子：三行代码加一个断点

配置完进入主界面，接下来跑通第一个程序。步骤很固定：

1. 点「新建项目」，选一个存放代码的文件夹，路径同样避开中文和空格。
2. 确认解释器那一栏选的是刚才配好的那个。
3. 在左侧项目树上右键，选「新建」→「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，再按 F8，print那一行执行完，输出一行。继续按，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，你装库用的是 A，PyCharm 用的是 B，两个不是同一个。解决办法：别在系统终端里装，直接用 PyCharm 底部的「终端」面板，那个终端默认激活的就是当前项目的解释器环境，在里面执行安装命令，装完就是对的。如果项目用了虚拟环境，注意每次打开新项目都要确认一下底部终端前面带没带环境标识。

6. 装好只是起点：接下来四周该练什么

软件装完、第一个程序跑通，很多人到这儿就停住了，因为不知道下一步该干什么。给你一条可以照着走的四周路线，每一项都对应 PyCharm 里的一个具体功能，别贪多，一周啃一个就够：

第一周千万别急着做项目。我见过太多人第一天就去找「新手练手项目」，结果照着抄了三百行，一行都看不懂，最后得出「我不适合学编程」的结论。真实情况是基础语法没打牢，抄得越多越挫败。

第二周开始刻意用断点。这一周的目标不是写出多漂亮的代码，而是养成一个习惯：程序结果不符合预期时，第一反应是打断点，而不是到处加print。这个习惯一旦养成，后面学任何语言都受用。

第三周开始你会遇到「代码越来越长，一个文件塞不下」的问题，这时候再去学怎么分文件、怎么建文件夹，动机是真实的，学起来也记得住。PyCharm 的项目树就是为这个准备的，右键新建、拖拽移动，比在文件管理器里操作直观得多。

第四周试着用一下版本控制面板。不用学命令行，就在界面里点「提交」，写一句这次改了什么，确认。然后故意改坏一个文件，再从历史记录里回滚回去。这个动作做一遍，你就理解了「后悔药」是什么意思——以后改代码胆子会大很多，因为知道随时能退回去。

最后说个我自己的血泪经验。我第一次装完这类开发工具的时候，觉得装好了就等于会用了，结果后面每次遇到问题都怀疑是环境配错了，来回重装了三遍，浪费的时间够学完一整个基础教程。从那以后我每次装完新工具，都强制先跑一个最小可运行的例子——就三行代码，能打印出东西、能打断点停下——确认这条链路通了，再去折腾别的东西。这个习惯帮我省掉了大量「到底是代码错了还是环境错了」的自我怀疑。

这份 PyCharm 安装教程.pdf 把三个系统的步骤都整理在一起了，卡住的时候翻一翻，比自己在网上东拼西凑要快得多。希望帮到你。

本文还有配套的精品资源，点击获取