简介PyCharm新手入门图文教程面向刚开始学习Python并需要快速上手PyCharm的开发者和学生以图文结合形式系统讲解创建项目、选择项目路径与虚拟环境、运行代码文件以及利用Run面板定位语法错误等关键基本功同时介绍了安装第三方库的三种常用方式并顺带提及虚拟环境管理、文件格式转换、模板创建和调试等进阶功能让零基础读者也能建立清晰的开发流程认知。资源本身为PDF文档共1个文件492KB轻量易读适合在电脑或平板上边看边操作目前已有9370人浏览学习。拿到手后可按章节顺序跟随步骤实践每一步都有界面示意与操作路径提示既能当系统教材也能作为日常速查手册针对初学者最常见的“环境不会创建、代码不知怎么跑、报错看不懂”等问题逐一演示解决路径是一份省心且高效的PyCharm入门参考资料。1. PyCharm 使用教程这份图文 PDF 为什么值得照着敲一遍很多人学 Python 装完 PyCharm 就卡在第一步打开软件看到一堆按钮不知道点哪里。网上教程要么只讲安装要么一上来就讲调试器、虚拟环境新手根本消化不了。这份《PyCharm使用教程详细版-图文结合》PDF 好就好在它只讲四件事——创建项目、运行代码、看错误提示、装第三方包全是头两周写 Python 必然会碰到的操作而且每一步都有截图对应。适合刚装好 PyCharm 还没写过几行代码的人也适合那些用记事本写 Python、想换 IDE 又怕学不会的零基础用户。我自己拆这份教程时发现它最值钱的地方不是截图多而是把「先建环境再写代码」这个习惯讲清楚了后面所有项目都不容易乱。2. 创建项目与解释器配置先搞懂 PyCharm 到底帮你做了什么2.1 Create New Project 背后藏着环境隔离的底层逻辑教程开篇让读者点 Create New Project看起来只是新建一个文件夹实际上 PyCharm 在这里做了三件事创建项目目录、生成一个.idea配置文件夹、把选定的 Python 解释器和项目绑定。很多新手不知道PyCharm 的项目文件里那个venv目录就是虚拟环境里面有独立的 Python 可执行文件和 pip你在这个项目里装什么包都不会污染系统 Python。这是 PDF 里「不仅新建了项目目录同时也配置好了开发环境」这句话的含义但教程因为面向入门没有展开我这里补一句如果你是用 Anaconda 管理 Python 环境创建项目时要在 interpreter 那一步展开箭头选 Existing interpreter 然后指向anaconda3/envs/你的环境名/python.exe这样新项目就能直接用你 conda 里装好的包。社区版和专业版在这个界面上操作一致区别只在远程开发和数据库工具学习阶段下载社区版就够了。项目路径的选择也有讲究。教程截图里默认路径是 C 盘用户目录但实际开发我一般建议放一个纯英文路径比如D:\code\project_name。原因有两个一是 PyCharm 的终端、调试器在某些 Windows 环境下对中文路径或带空格路径处理会出幺蛾子报一些莫名的 FileNotFoundError二是你以后要用 Git 管理代码中文路径在部分 Git 客户端显示会乱码。PDF 里没提这点但按照教程操作时如果路径这一步选错后面运行代码遇到奇怪报错十有八九是路径的坑。创建完成后进入 IDE 主界面File → New 下面有好几个选项。这里初学者最常混淆的是Directory和Python PackagePDF 特意提了一句「2 是带包的目录可以被直接 import」但没有解释为什么。下面小节展开讲。2.2 普通目录和 Python Package 的区别一个__init__.py的距离步骤里说的两个选项界面英文显示为 Directory普通目录和 Python PackagePython 包中文版分别叫「目录」和「Python 包」。两者的物理差别只有一个Python Package 会自动生成一个名为__init__.py的空文件有了这个文件Python 解释器就会把该目录当作一个包于是你在其他模块里用import语句导入它时不会报错。# 假设项目结构如下 # my_project/ # utils/ # __init__.py # helper.py # main.py # main.py 内可以这样导入 from utils.helper import some_function # 如果 utils 是普通目录没有 __init__.py # 上面的 import 在 Python 3.3 其实也不会报错隐式命名空间包 # 但在 PyCharm 的代码补全和重构功能下包结构识别会不正常。这段代码想说明的是从 Python 3.3 开始普通目录也能被导入但 PyCharm 对普通目录的 import 支持是残缺的——自动补全可能不出提示跳转到定义也可能失效。列这个对比是想让你在创建目录时养成习惯凡是打算放工具的目录一律选 Python Package哪怕现在不 import以后代码多了肯定要拆模块到时候再补__init__.py就要手动创建多余文件。2.3 解释器配置的常见误区和初始检查清单新建项目的最后一步是展开 Project Interpreter 那一栏教程没细说这里怎么选。常见做法是如果电脑上只装了官方 Python直接默认 New environment using Virtualenv 就行如果装了 Anaconda建议选 Existing environment这样不用重复装 pandas、numpy 这类重型包。我个人在给团队新手配环境时统一要求用 Anaconda 的虚拟环境 PyCharm 的 Existing environment 组合因为 conda 对二进制包的支持比 pip 省心装 scrapy 或 dlib 这类带编译的库时不用折腾 Visual C Build Tools。选完解释器后还需要手动验证一遍三件事这也是我从这份 PDF 的操作步骤里延伸出的检查习惯打开 Settings → Project: xxx → Python Interpreter确认右侧路径真实存在。在项目里建一个test.py输入import sys; print(sys.executable)运行看打印出的路径是否和 PyCharm 显示的一致。打开 Terminal 标签页输入pip --version确认当前终端指向的 pip 属于选中解释器。第 2 步和第 3 步经常发现不一致——PyCharm 里选的是 conda 环境但 Terminal 打开的却是系统默认 Python。这时需要在 Settings 里把 Terminal 的 Shell path 改成当前环境的python.exe所在目录或者用conda activate手动激活。PDF 后面有专门一小节省略没讲的部分其实就是这些。3. 运行代码与调试入门三个绿色三角符号别乱点3.1 三个运行入口的区别Run 按钮、右键菜单和行内箭头教程里写了在test.py看到一个 for 循环代码可以运行界面上同时出现三个绿色三角——左侧 gutter 的行内运行箭头、主工具栏的 Run 按钮、右键菜单里的 Run 选项。PDF 说「不方便演示」「最好选右键下面的绿色三角」这里我给你拆清楚三者差异因为选错了在多人协作时很要命。主工具栏的 Run 按钮它运行的是当前 PyCharm 的 Run Configuration 里指定的脚本不是鼠标聚焦的那个文件。假设你上次运行过a.py这次打开b.py点上方绿色三角实际跑的还是a.py新手经常在这翻车看半天以为代码没保存。左侧 gutter 行内箭头只出现在有main入口或当前文件里点击它会弹出菜单选择运行哪个配置本质上和右键 Run 等价但如果你在一个文件里有多个可执行代码块比如 Notebook 风格的脚本行内箭头会帮你区分是哪一段。右键菜单的 Run最推荐给新手是因为它操作意图最明确——鼠标停在哪个文件上右键就是运行哪个文件不会受上一次运行历史干扰。右键还会顺手生成一个以文件名命名的 Run Configuration下次点工具栏按钮会默认跑这个文件逻辑上可预期。# 如果你更喜欢用快捷键记住这三个就够用了 # Shift F10 运行当前配置的文件 # Shift F9 调试当前配置的文件 # Ctrl F8 在当前行添加/取消断点调试前提3.2 运行输出和错误提示怎么读Run 面板的分区逻辑PDF 里提到「如果代码有错误PyCharm 下面的 run 中会有提示」这句话对但不完整。PyCharm 的 Run 工具窗实际上分两个 tab——Run 和 Console默认不会同时打开。程序崩溃时输出是红色文字加 Traceback 堆栈信息关键是看最后一行Exception: xxx下面跟着的是出错的文件名和行号直接用鼠标点那个蓝色文件名就能跳到出错代码行。PDF 没讲的是有些错误不会出现在 Run 面板而是直接显示在编辑区代码下方——比如未定义的变量名下面会有红色波浪线鼠标悬停会提示Unresolved reference。这类静态分析错误不需要运行就能看到PyCharm 在输入时就实时检查了。错误提示的优先级按照我排错的经验先看编辑区的红色波浪线语法错误再看 Run 面板最后几行运行时报错最后看黄色灯泡图标提示代码警告不影响运行但影响规范。很多人一看到红色报错就慌其实 PyCharm 的提示已经帮你标好了正确位置照着改就行。3.3 从运行到调试把 PDF 没展开的 Debug 窗口补给你PDF 末尾写了「后面视频课程中会带着讲调试」但实际产品里调试就是一个按钮的事等视频不如现在就会。调试的前提是设置断点——在代码行号右侧的灰色区域点一下出现红色圆点即可。然后点工具栏的 Debug 按钮不是 Run程序会在断点处暂停底部弹出 Debug 窗口。Debug 窗口五个关键区域按使用频率排序Frames 面板显示当前函数调用栈看程序是怎么一层层进到当前代码的Variables 面板实时查看所有局部变量的当前值字典、列表可以展开看内部结构Watches 面板手动添加表达式比如输入i * 2就能在每步暂停时直接看到计算结果Console 面板可以执行任意 Python 表达式临时验证某个函数返回值Threads 面板多线程调试时看每个线程的暂停位置调试中最常用的一组操作Step OverF8逐行执行Step IntoF7进入函数内部Step OutShift F8跳出当前函数ResumeF9运行到下一个断点。初学者刚开始只要会用 F7 和 F8 就够PDF 里那个 for 循环的例子用 F8 逐行走一遍立刻能看清变量i的变化过程。4. 安装第三方包三种方式的选择与 pip 环境错位问题4.1 CMD、Terminal、Settings 三种安装方式对比教程里给了安装三方包的三个入口系统 CMD、PyCharm 内置 Terminal、Settings 里的解释器管理界面。PDF 说 Settings 是推荐方法这个结论到现在依然成立但推荐的理由值得展开。用系统 CMD 安装有个致命隐患——你当前命令行所在的环境不一定是 PyCharm 项目的环境。比如项目用的是 Anaconda 的 base 环境但系统 CMD 默认激活的不是 base跑pip install pandas装到了另一个 Python 里PyCharm 里照样报ModuleNotFoundError。Terminal 标签页也有这个问题只是 PyCharm 的 Terminal 会自动激活当前项目关联的虚拟环境前提是你在 Settings 里没改动 Shell path所以比系统 CMD 靠谱。给你看下最稳妥的 Terminal 安装方式# 第一步确认当前环境 python --version pip --version # 第二步安装包注意以下命令要在 PyCharm 的 Terminal 里执行 pip install pandas # 如果网速慢或访问超时换国内镜像源 pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple # 第三步验证安装是否真正进入当前环境 pip show pandas | findstr Location # 看到 Location 指向项目 venv 或指定 conda env 才算成功上面findstr是 Windows 下的过滤命令macOS/Linux 换成grep Location。这套验证步骤是我被坑过几次后总结出来的第二和第三步顺序不能换因为 pip 有两套一个属于系统 Python一个属于虚拟环境。命令行下pip --version显示的是当前环境如果你发现在 CMD 装包后 PyCharm 里 import 还是报错基本就是环境错位。4.2 Settings 安装为什么最省心以 pandas 为例实操Settings → Project: 项目名 → Python Interpreter → 点击右侧的 号弹出的搜索框里输入pandas勾选版本号一般选最新稳定版点 Install Package。这一步 PyCharm 会自动发起pip install并把它安装到当前项目绑定的解释器路径下不关心你系统里几个 Python也不涉及 PATH 优先级问题出错概率最低。安装完成后这一行会出现在已安装包列表里点击它可以看到版本号、安装位置和依赖列表。用 pandas 当例子有代表性pandas 依赖 numpy 和 python-dateutilPyCharm 在安装时会把依赖一起装上并在界面里用向下的箭头标识「作为依赖被安装」这一点对新手很友好。学术上如果你在 CMD 手动装pip 其实也会自动处理依赖只是你肉眼看不到过程出了错也不知道是哪个依赖冲突。Settings 方式适合日常装包Terminal 方式适合批量装或者要指定镜像源的情况CMD 方式基本可以放弃除非你没打开 PyCharm 也能确知环境路径。还有一点2024 年之后的 PyCharm 版本把解释器设置界面合并进了 Settings → Project → Python Interpreter旧教程截图里叫 Project Interpreter看着不一样但功能相同。社区版和专业版在这个界面上没有任何区别不会出现社区版不能装包的情况。4.3 遇到 pip 相关报错时先自查这三个方向新手装包最常见的报错和解决思路按概率排序pip is not recognizedPATH 里没有 pip 命令解决方法是重新安装 Python 时勾选 Add to PATH或者直接用python -m pip install 包名绕开 pip 直接调用模块。Read timed out网络问题换国内镜像源就能解决上面代码块里已经给了命令。Microsoft Visual C 14.0 is required说明这个包有 C 扩展需要编译。先用pip install wheel再试还是报错就去找这个包对应的.whl预编译文件用pip install 文件名.whl安装。ERROR: Could not install packages due to an OSError: [WinError 5] 拒绝访问权限不足用管理员身份打开 CMD 或 Terminal 再装。装进 venv 的包一般不涉及这个错误如果你把包直接装进了系统 Python 就大概率遇到。PDF 里对安装包方法一带而过但其实前三类报错占了新手学习 PyCharm 一半的求助量建议把上面四条存下来当自查清单用。5. 避坑与常见问题排查PyCharm 实操中我踩过的五个典型坑5.1 坑一教程示例代码的变量覆盖问题PDF 正文里的示例代码是import random i [1, 2, 3] for i in range(1, 10): print(i)这段代码能跑通但i [1, 2, 3]在循环开始后就被range(1, 10)覆盖循环结束再引用i拿到的是整数而不是列表。如果按教程把这行代码输入 PyCharm会看到第二条赋值语句下面没有任何警告——PyCharm 不会提示i被重新赋值因为这在 Python 语义上是合法的。但实际工作中这是一种坏味道代码评审遇到这种写法会被打回重写。你自己练习时建议改成import random num_list [1, 2, 3] for i in range(1, 10): print(i, num_list)现象跟着 PDF 敲代码运行成功但逻辑结果和预期不符。原因教程作者的示例代码本身存在变量名复用问题pdf 制作时为了保证截图效果没有区分列表名和循环变量。解决养成给变量起有意义的名的习惯i、j、k这类短名只做循环迭代变量使用正式数据用num_list、user_info这类描述性名字。5.2 坑二运行时提示 No module named xxx但 Settings 里明明可以看到包现象Settings 里能搜到 pandas 且显示已安装运行时却报ModuleNotFoundError: No module named pandas。原因PyCharm 项目绑定的解释器和运行代码时的解释器不是同一个。这种情况通常出现在你手动改了项目解释器但旧的 Run Configuration 里还缓存着旧解释器路径或者你选了不同虚拟环境后没重新打开项目。解决打开 Settings → Project → Python Interpreter确认路径然后右键主工具栏的运行配置就是当前文件名的那个下拉框选择 Edit Configurations在 Python interpreter 一栏选择 Default project interpreter改完后再点一次运行让 Run Configuration 重新加载。这个坑最隐蔽的地方在于 PyCharm 有时候不会主动刷新 Run Configuration 里的解释器必须手动去 Edit Configurations 里改我从 PyCharm 2020 版到 2025 版都遇到过不是个例。5.3 坑三普通目录建多了import 时 PyCharm 不给自动补全现象把所有文件夹都创建为普通 Directory后来代码报ModuleNotFoundErrorPyCharm 里 import 后没有代码提示跳转也不行。原因没有用 Python Package 创建带__init__.py的包目录或者说目录是普通目录IDE 没有把它标记为源码根目录。解决在某个目录上右键 → Mark Directory as → Sources Root。这一步告诉 PyCharm「从这个目录往下的代码都是可以导入的源文件」。如果是已经存在的项目没有__init__.py补建空文件更符合 Python 包规范Mark as Sources Root 是给那些不想改动目录结构的旧项目用的。两种搞法选一种就行但 Mark as Sources Root 是项目级设置换机器拉代码后要重新标记建__init__.py是代码级方案提交到 Git 后别人拉下来就自动生效。多人协作推荐后者。5.4 坑四双击 .py 文件直接打开结果没有提示且无法运行现象在 Windows 资源管理器里双击.py文件Windows 会用 PyCharm 打开文件窗口但代码没有语法高亮右键没有 Run主界面缺失项目结构。原因PyCharm 打开单文件时进入的是 File 视图模式——它不是没有处理 PyCharm 的文件关联而是把文件当作孤立文件打开了此时没有绑定任何项目解释器。解决不要用 File → Open 打开单个.py要用 File → Open 选中整个项目文件夹或者把.py文件放到已有项目目录里再打开。老手还有一种做法右键项目目录 → Open Folder as PyCharm Project让整个目录以项目形式加载。这个坑对新手的迷惑性极强因为 PyCharm 装着装着「好好的怎么突然不智能了」十有八九是单文件模式。5.5 坑五Changelist 和本地历史——被覆盖后找不到代码的后悔药现象改了一段代码没提交 Git后来改崩了想回退发现 CtrlZ 已经按了十几次回不到最初版本。原因PyCharm 的本地历史是独立于 Git 的版本快照默认关闭很多人不知道这个功能存在。解决对文件右键 → Local History → Show HistoryPyCharm 会列出该文件最近几小时到几天的修改记录选中任意版本点 Revert 就能找回。如果只是个别文件被覆盖这是最快的后悔药不用惊动 Git。这也是我看完 PDF 后最想提醒的事——PDF 没讲快捷键、没讲版本控制但 Windows 用户用 PyCharm 至少要知道 Local History 是保命功能。6. 进阶技巧把 PyCharm 从编辑器调教成趁手工具的三个习惯PDF 最后一段埋了虚拟环境安装、文件格式转换、模板创建、调试几个高级话题但都没有展开。这章挑三个实际场景最常用的技巧展开不贪多每个能立刻见效果。第一个技巧是自定义代码模板。写 Python 文件时每次都要补头部注释、import 语句手工敲浪费时间。打开 Settings → Editor → File and Code Templates → Python Script把模板改成#!/usr/bin/env python # -*- coding: utf-8 -*- # Author : your_name # File : ${NAME}.py # Date : ${DATE} ${TIME}${NAME}、${DATE}、${TIME}是 PyCharm 预置的模板变量新建 Python 文件时自动替换成文件名和当前时间。这个功能对应 PDF 说的「模板创建」入门阶段用它能减少重复劳动也能让日常代码风格统一。同理新建 Flask 项目、Django 项目时框架自带模板已经帮你生成好目录结构不需要每次都手动建。第二个技巧是文件格式转换。PDF 提到的「文件格式转换」在 PyCharm 里最常见的场景是两个一是行尾符CRLF/LF转换Windows 下编辑的文件提交给 Linux 服务器会出现\r报错选中内容后打开 Edit → EOL Conversion → Unix(LF) 一步搞定二是编码转换出现中文乱码时把 File Encoding 从 GBK 改成 UTF-8勾选 Transparent native-to-ascii conversion 选项项目文件就不会在 Git 里产生无意义的 diff。网上问「PyCharm 怎么改成中文」其实也算一种格式转换——Settings → Plugins 里搜 Chinese Language Pack 插件安装重启就是中文界面2023 版之后官方一直维护这个中文包。第三个技巧是 AI 插件的边界掌握。PyCharm 2025 版主推 JetBrains AI Assistant社区版也能在插件市场装 ChatGPT Codex 或 GitHub Copilot。我给团队配环境的建议是代码补全类 AI 用着没问题能省不少记 API 的时间但涉及项目配置、解释器问题不要问 AI 直接改 settings——AI 给的配置修改方式在 PyCharm 不同大版本界面差异大改乱了不如手动来找。2025.1.1.1 版本的 AI 插件已经能直接在 Terminal 里辅助跑命令但验证环境正确性最终还得靠人工上面提的三个检查步骤不能省。使用 PyCharm 有段时间后我形成的一个死习惯是每次新建项目只走固定流程建目录、选解释器、标记 Sources Root再跑第一行 print。从那以后我很少再被环境问题缠住。PyCharm 真正的威力不在按钮多而在于它能替你管好环境、跑清楚逻辑这份 PDF 把入口讲明白了剩下的坑和用法慢慢踩慢慢补就好。希望帮到你。本文还有配套的精品资源点击获取
PyCharm使用教程：从项目创建、调试到pip安装的避坑指南
简介PyCharm新手入门图文教程面向刚开始学习Python并需要快速上手PyCharm的开发者和学生以图文结合形式系统讲解创建项目、选择项目路径与虚拟环境、运行代码文件以及利用Run面板定位语法错误等关键基本功同时介绍了安装第三方库的三种常用方式并顺带提及虚拟环境管理、文件格式转换、模板创建和调试等进阶功能让零基础读者也能建立清晰的开发流程认知。资源本身为PDF文档共1个文件492KB轻量易读适合在电脑或平板上边看边操作目前已有9370人浏览学习。拿到手后可按章节顺序跟随步骤实践每一步都有界面示意与操作路径提示既能当系统教材也能作为日常速查手册针对初学者最常见的“环境不会创建、代码不知怎么跑、报错看不懂”等问题逐一演示解决路径是一份省心且高效的PyCharm入门参考资料。1. PyCharm 使用教程这份图文 PDF 为什么值得照着敲一遍很多人学 Python 装完 PyCharm 就卡在第一步打开软件看到一堆按钮不知道点哪里。网上教程要么只讲安装要么一上来就讲调试器、虚拟环境新手根本消化不了。这份《PyCharm使用教程详细版-图文结合》PDF 好就好在它只讲四件事——创建项目、运行代码、看错误提示、装第三方包全是头两周写 Python 必然会碰到的操作而且每一步都有截图对应。适合刚装好 PyCharm 还没写过几行代码的人也适合那些用记事本写 Python、想换 IDE 又怕学不会的零基础用户。我自己拆这份教程时发现它最值钱的地方不是截图多而是把「先建环境再写代码」这个习惯讲清楚了后面所有项目都不容易乱。2. 创建项目与解释器配置先搞懂 PyCharm 到底帮你做了什么2.1 Create New Project 背后藏着环境隔离的底层逻辑教程开篇让读者点 Create New Project看起来只是新建一个文件夹实际上 PyCharm 在这里做了三件事创建项目目录、生成一个.idea配置文件夹、把选定的 Python 解释器和项目绑定。很多新手不知道PyCharm 的项目文件里那个venv目录就是虚拟环境里面有独立的 Python 可执行文件和 pip你在这个项目里装什么包都不会污染系统 Python。这是 PDF 里「不仅新建了项目目录同时也配置好了开发环境」这句话的含义但教程因为面向入门没有展开我这里补一句如果你是用 Anaconda 管理 Python 环境创建项目时要在 interpreter 那一步展开箭头选 Existing interpreter 然后指向anaconda3/envs/你的环境名/python.exe这样新项目就能直接用你 conda 里装好的包。社区版和专业版在这个界面上操作一致区别只在远程开发和数据库工具学习阶段下载社区版就够了。项目路径的选择也有讲究。教程截图里默认路径是 C 盘用户目录但实际开发我一般建议放一个纯英文路径比如D:\code\project_name。原因有两个一是 PyCharm 的终端、调试器在某些 Windows 环境下对中文路径或带空格路径处理会出幺蛾子报一些莫名的 FileNotFoundError二是你以后要用 Git 管理代码中文路径在部分 Git 客户端显示会乱码。PDF 里没提这点但按照教程操作时如果路径这一步选错后面运行代码遇到奇怪报错十有八九是路径的坑。创建完成后进入 IDE 主界面File → New 下面有好几个选项。这里初学者最常混淆的是Directory和Python PackagePDF 特意提了一句「2 是带包的目录可以被直接 import」但没有解释为什么。下面小节展开讲。2.2 普通目录和 Python Package 的区别一个__init__.py的距离步骤里说的两个选项界面英文显示为 Directory普通目录和 Python PackagePython 包中文版分别叫「目录」和「Python 包」。两者的物理差别只有一个Python Package 会自动生成一个名为__init__.py的空文件有了这个文件Python 解释器就会把该目录当作一个包于是你在其他模块里用import语句导入它时不会报错。# 假设项目结构如下 # my_project/ # utils/ # __init__.py # helper.py # main.py # main.py 内可以这样导入 from utils.helper import some_function # 如果 utils 是普通目录没有 __init__.py # 上面的 import 在 Python 3.3 其实也不会报错隐式命名空间包 # 但在 PyCharm 的代码补全和重构功能下包结构识别会不正常。这段代码想说明的是从 Python 3.3 开始普通目录也能被导入但 PyCharm 对普通目录的 import 支持是残缺的——自动补全可能不出提示跳转到定义也可能失效。列这个对比是想让你在创建目录时养成习惯凡是打算放工具的目录一律选 Python Package哪怕现在不 import以后代码多了肯定要拆模块到时候再补__init__.py就要手动创建多余文件。2.3 解释器配置的常见误区和初始检查清单新建项目的最后一步是展开 Project Interpreter 那一栏教程没细说这里怎么选。常见做法是如果电脑上只装了官方 Python直接默认 New environment using Virtualenv 就行如果装了 Anaconda建议选 Existing environment这样不用重复装 pandas、numpy 这类重型包。我个人在给团队新手配环境时统一要求用 Anaconda 的虚拟环境 PyCharm 的 Existing environment 组合因为 conda 对二进制包的支持比 pip 省心装 scrapy 或 dlib 这类带编译的库时不用折腾 Visual C Build Tools。选完解释器后还需要手动验证一遍三件事这也是我从这份 PDF 的操作步骤里延伸出的检查习惯打开 Settings → Project: xxx → Python Interpreter确认右侧路径真实存在。在项目里建一个test.py输入import sys; print(sys.executable)运行看打印出的路径是否和 PyCharm 显示的一致。打开 Terminal 标签页输入pip --version确认当前终端指向的 pip 属于选中解释器。第 2 步和第 3 步经常发现不一致——PyCharm 里选的是 conda 环境但 Terminal 打开的却是系统默认 Python。这时需要在 Settings 里把 Terminal 的 Shell path 改成当前环境的python.exe所在目录或者用conda activate手动激活。PDF 后面有专门一小节省略没讲的部分其实就是这些。3. 运行代码与调试入门三个绿色三角符号别乱点3.1 三个运行入口的区别Run 按钮、右键菜单和行内箭头教程里写了在test.py看到一个 for 循环代码可以运行界面上同时出现三个绿色三角——左侧 gutter 的行内运行箭头、主工具栏的 Run 按钮、右键菜单里的 Run 选项。PDF 说「不方便演示」「最好选右键下面的绿色三角」这里我给你拆清楚三者差异因为选错了在多人协作时很要命。主工具栏的 Run 按钮它运行的是当前 PyCharm 的 Run Configuration 里指定的脚本不是鼠标聚焦的那个文件。假设你上次运行过a.py这次打开b.py点上方绿色三角实际跑的还是a.py新手经常在这翻车看半天以为代码没保存。左侧 gutter 行内箭头只出现在有main入口或当前文件里点击它会弹出菜单选择运行哪个配置本质上和右键 Run 等价但如果你在一个文件里有多个可执行代码块比如 Notebook 风格的脚本行内箭头会帮你区分是哪一段。右键菜单的 Run最推荐给新手是因为它操作意图最明确——鼠标停在哪个文件上右键就是运行哪个文件不会受上一次运行历史干扰。右键还会顺手生成一个以文件名命名的 Run Configuration下次点工具栏按钮会默认跑这个文件逻辑上可预期。# 如果你更喜欢用快捷键记住这三个就够用了 # Shift F10 运行当前配置的文件 # Shift F9 调试当前配置的文件 # Ctrl F8 在当前行添加/取消断点调试前提3.2 运行输出和错误提示怎么读Run 面板的分区逻辑PDF 里提到「如果代码有错误PyCharm 下面的 run 中会有提示」这句话对但不完整。PyCharm 的 Run 工具窗实际上分两个 tab——Run 和 Console默认不会同时打开。程序崩溃时输出是红色文字加 Traceback 堆栈信息关键是看最后一行Exception: xxx下面跟着的是出错的文件名和行号直接用鼠标点那个蓝色文件名就能跳到出错代码行。PDF 没讲的是有些错误不会出现在 Run 面板而是直接显示在编辑区代码下方——比如未定义的变量名下面会有红色波浪线鼠标悬停会提示Unresolved reference。这类静态分析错误不需要运行就能看到PyCharm 在输入时就实时检查了。错误提示的优先级按照我排错的经验先看编辑区的红色波浪线语法错误再看 Run 面板最后几行运行时报错最后看黄色灯泡图标提示代码警告不影响运行但影响规范。很多人一看到红色报错就慌其实 PyCharm 的提示已经帮你标好了正确位置照着改就行。3.3 从运行到调试把 PDF 没展开的 Debug 窗口补给你PDF 末尾写了「后面视频课程中会带着讲调试」但实际产品里调试就是一个按钮的事等视频不如现在就会。调试的前提是设置断点——在代码行号右侧的灰色区域点一下出现红色圆点即可。然后点工具栏的 Debug 按钮不是 Run程序会在断点处暂停底部弹出 Debug 窗口。Debug 窗口五个关键区域按使用频率排序Frames 面板显示当前函数调用栈看程序是怎么一层层进到当前代码的Variables 面板实时查看所有局部变量的当前值字典、列表可以展开看内部结构Watches 面板手动添加表达式比如输入i * 2就能在每步暂停时直接看到计算结果Console 面板可以执行任意 Python 表达式临时验证某个函数返回值Threads 面板多线程调试时看每个线程的暂停位置调试中最常用的一组操作Step OverF8逐行执行Step IntoF7进入函数内部Step OutShift F8跳出当前函数ResumeF9运行到下一个断点。初学者刚开始只要会用 F7 和 F8 就够PDF 里那个 for 循环的例子用 F8 逐行走一遍立刻能看清变量i的变化过程。4. 安装第三方包三种方式的选择与 pip 环境错位问题4.1 CMD、Terminal、Settings 三种安装方式对比教程里给了安装三方包的三个入口系统 CMD、PyCharm 内置 Terminal、Settings 里的解释器管理界面。PDF 说 Settings 是推荐方法这个结论到现在依然成立但推荐的理由值得展开。用系统 CMD 安装有个致命隐患——你当前命令行所在的环境不一定是 PyCharm 项目的环境。比如项目用的是 Anaconda 的 base 环境但系统 CMD 默认激活的不是 base跑pip install pandas装到了另一个 Python 里PyCharm 里照样报ModuleNotFoundError。Terminal 标签页也有这个问题只是 PyCharm 的 Terminal 会自动激活当前项目关联的虚拟环境前提是你在 Settings 里没改动 Shell path所以比系统 CMD 靠谱。给你看下最稳妥的 Terminal 安装方式# 第一步确认当前环境 python --version pip --version # 第二步安装包注意以下命令要在 PyCharm 的 Terminal 里执行 pip install pandas # 如果网速慢或访问超时换国内镜像源 pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple # 第三步验证安装是否真正进入当前环境 pip show pandas | findstr Location # 看到 Location 指向项目 venv 或指定 conda env 才算成功上面findstr是 Windows 下的过滤命令macOS/Linux 换成grep Location。这套验证步骤是我被坑过几次后总结出来的第二和第三步顺序不能换因为 pip 有两套一个属于系统 Python一个属于虚拟环境。命令行下pip --version显示的是当前环境如果你发现在 CMD 装包后 PyCharm 里 import 还是报错基本就是环境错位。4.2 Settings 安装为什么最省心以 pandas 为例实操Settings → Project: 项目名 → Python Interpreter → 点击右侧的 号弹出的搜索框里输入pandas勾选版本号一般选最新稳定版点 Install Package。这一步 PyCharm 会自动发起pip install并把它安装到当前项目绑定的解释器路径下不关心你系统里几个 Python也不涉及 PATH 优先级问题出错概率最低。安装完成后这一行会出现在已安装包列表里点击它可以看到版本号、安装位置和依赖列表。用 pandas 当例子有代表性pandas 依赖 numpy 和 python-dateutilPyCharm 在安装时会把依赖一起装上并在界面里用向下的箭头标识「作为依赖被安装」这一点对新手很友好。学术上如果你在 CMD 手动装pip 其实也会自动处理依赖只是你肉眼看不到过程出了错也不知道是哪个依赖冲突。Settings 方式适合日常装包Terminal 方式适合批量装或者要指定镜像源的情况CMD 方式基本可以放弃除非你没打开 PyCharm 也能确知环境路径。还有一点2024 年之后的 PyCharm 版本把解释器设置界面合并进了 Settings → Project → Python Interpreter旧教程截图里叫 Project Interpreter看着不一样但功能相同。社区版和专业版在这个界面上没有任何区别不会出现社区版不能装包的情况。4.3 遇到 pip 相关报错时先自查这三个方向新手装包最常见的报错和解决思路按概率排序pip is not recognizedPATH 里没有 pip 命令解决方法是重新安装 Python 时勾选 Add to PATH或者直接用python -m pip install 包名绕开 pip 直接调用模块。Read timed out网络问题换国内镜像源就能解决上面代码块里已经给了命令。Microsoft Visual C 14.0 is required说明这个包有 C 扩展需要编译。先用pip install wheel再试还是报错就去找这个包对应的.whl预编译文件用pip install 文件名.whl安装。ERROR: Could not install packages due to an OSError: [WinError 5] 拒绝访问权限不足用管理员身份打开 CMD 或 Terminal 再装。装进 venv 的包一般不涉及这个错误如果你把包直接装进了系统 Python 就大概率遇到。PDF 里对安装包方法一带而过但其实前三类报错占了新手学习 PyCharm 一半的求助量建议把上面四条存下来当自查清单用。5. 避坑与常见问题排查PyCharm 实操中我踩过的五个典型坑5.1 坑一教程示例代码的变量覆盖问题PDF 正文里的示例代码是import random i [1, 2, 3] for i in range(1, 10): print(i)这段代码能跑通但i [1, 2, 3]在循环开始后就被range(1, 10)覆盖循环结束再引用i拿到的是整数而不是列表。如果按教程把这行代码输入 PyCharm会看到第二条赋值语句下面没有任何警告——PyCharm 不会提示i被重新赋值因为这在 Python 语义上是合法的。但实际工作中这是一种坏味道代码评审遇到这种写法会被打回重写。你自己练习时建议改成import random num_list [1, 2, 3] for i in range(1, 10): print(i, num_list)现象跟着 PDF 敲代码运行成功但逻辑结果和预期不符。原因教程作者的示例代码本身存在变量名复用问题pdf 制作时为了保证截图效果没有区分列表名和循环变量。解决养成给变量起有意义的名的习惯i、j、k这类短名只做循环迭代变量使用正式数据用num_list、user_info这类描述性名字。5.2 坑二运行时提示 No module named xxx但 Settings 里明明可以看到包现象Settings 里能搜到 pandas 且显示已安装运行时却报ModuleNotFoundError: No module named pandas。原因PyCharm 项目绑定的解释器和运行代码时的解释器不是同一个。这种情况通常出现在你手动改了项目解释器但旧的 Run Configuration 里还缓存着旧解释器路径或者你选了不同虚拟环境后没重新打开项目。解决打开 Settings → Project → Python Interpreter确认路径然后右键主工具栏的运行配置就是当前文件名的那个下拉框选择 Edit Configurations在 Python interpreter 一栏选择 Default project interpreter改完后再点一次运行让 Run Configuration 重新加载。这个坑最隐蔽的地方在于 PyCharm 有时候不会主动刷新 Run Configuration 里的解释器必须手动去 Edit Configurations 里改我从 PyCharm 2020 版到 2025 版都遇到过不是个例。5.3 坑三普通目录建多了import 时 PyCharm 不给自动补全现象把所有文件夹都创建为普通 Directory后来代码报ModuleNotFoundErrorPyCharm 里 import 后没有代码提示跳转也不行。原因没有用 Python Package 创建带__init__.py的包目录或者说目录是普通目录IDE 没有把它标记为源码根目录。解决在某个目录上右键 → Mark Directory as → Sources Root。这一步告诉 PyCharm「从这个目录往下的代码都是可以导入的源文件」。如果是已经存在的项目没有__init__.py补建空文件更符合 Python 包规范Mark as Sources Root 是给那些不想改动目录结构的旧项目用的。两种搞法选一种就行但 Mark as Sources Root 是项目级设置换机器拉代码后要重新标记建__init__.py是代码级方案提交到 Git 后别人拉下来就自动生效。多人协作推荐后者。5.4 坑四双击 .py 文件直接打开结果没有提示且无法运行现象在 Windows 资源管理器里双击.py文件Windows 会用 PyCharm 打开文件窗口但代码没有语法高亮右键没有 Run主界面缺失项目结构。原因PyCharm 打开单文件时进入的是 File 视图模式——它不是没有处理 PyCharm 的文件关联而是把文件当作孤立文件打开了此时没有绑定任何项目解释器。解决不要用 File → Open 打开单个.py要用 File → Open 选中整个项目文件夹或者把.py文件放到已有项目目录里再打开。老手还有一种做法右键项目目录 → Open Folder as PyCharm Project让整个目录以项目形式加载。这个坑对新手的迷惑性极强因为 PyCharm 装着装着「好好的怎么突然不智能了」十有八九是单文件模式。5.5 坑五Changelist 和本地历史——被覆盖后找不到代码的后悔药现象改了一段代码没提交 Git后来改崩了想回退发现 CtrlZ 已经按了十几次回不到最初版本。原因PyCharm 的本地历史是独立于 Git 的版本快照默认关闭很多人不知道这个功能存在。解决对文件右键 → Local History → Show HistoryPyCharm 会列出该文件最近几小时到几天的修改记录选中任意版本点 Revert 就能找回。如果只是个别文件被覆盖这是最快的后悔药不用惊动 Git。这也是我看完 PDF 后最想提醒的事——PDF 没讲快捷键、没讲版本控制但 Windows 用户用 PyCharm 至少要知道 Local History 是保命功能。6. 进阶技巧把 PyCharm 从编辑器调教成趁手工具的三个习惯PDF 最后一段埋了虚拟环境安装、文件格式转换、模板创建、调试几个高级话题但都没有展开。这章挑三个实际场景最常用的技巧展开不贪多每个能立刻见效果。第一个技巧是自定义代码模板。写 Python 文件时每次都要补头部注释、import 语句手工敲浪费时间。打开 Settings → Editor → File and Code Templates → Python Script把模板改成#!/usr/bin/env python # -*- coding: utf-8 -*- # Author : your_name # File : ${NAME}.py # Date : ${DATE} ${TIME}${NAME}、${DATE}、${TIME}是 PyCharm 预置的模板变量新建 Python 文件时自动替换成文件名和当前时间。这个功能对应 PDF 说的「模板创建」入门阶段用它能减少重复劳动也能让日常代码风格统一。同理新建 Flask 项目、Django 项目时框架自带模板已经帮你生成好目录结构不需要每次都手动建。第二个技巧是文件格式转换。PDF 提到的「文件格式转换」在 PyCharm 里最常见的场景是两个一是行尾符CRLF/LF转换Windows 下编辑的文件提交给 Linux 服务器会出现\r报错选中内容后打开 Edit → EOL Conversion → Unix(LF) 一步搞定二是编码转换出现中文乱码时把 File Encoding 从 GBK 改成 UTF-8勾选 Transparent native-to-ascii conversion 选项项目文件就不会在 Git 里产生无意义的 diff。网上问「PyCharm 怎么改成中文」其实也算一种格式转换——Settings → Plugins 里搜 Chinese Language Pack 插件安装重启就是中文界面2023 版之后官方一直维护这个中文包。第三个技巧是 AI 插件的边界掌握。PyCharm 2025 版主推 JetBrains AI Assistant社区版也能在插件市场装 ChatGPT Codex 或 GitHub Copilot。我给团队配环境的建议是代码补全类 AI 用着没问题能省不少记 API 的时间但涉及项目配置、解释器问题不要问 AI 直接改 settings——AI 给的配置修改方式在 PyCharm 不同大版本界面差异大改乱了不如手动来找。2025.1.1.1 版本的 AI 插件已经能直接在 Terminal 里辅助跑命令但验证环境正确性最终还得靠人工上面提的三个检查步骤不能省。使用 PyCharm 有段时间后我形成的一个死习惯是每次新建项目只走固定流程建目录、选解释器、标记 Sources Root再跑第一行 print。从那以后我很少再被环境问题缠住。PyCharm 真正的威力不在按钮多而在于它能替你管好环境、跑清楚逻辑这份 PDF 把入口讲明白了剩下的坑和用法慢慢踩慢慢补就好。希望帮到你。本文还有配套的精品资源点击获取