Python PyCharm 新手安装与高效使用指南
① 系统环境检查与版本选择策略
在动手之前,先花两分钟确认一下电脑能不能跑得动 PyCharm。
硬件要求:CPU 需要 x86_64 或 arm64 架构、4 核以上;内存建议 8GB 起步(其中留给 IDE 本身至少 3GB);硬盘预留 10GB 以上空间;屏幕分辨率不低于 1280×720。
操作系统:Windows 10/11(64 位)、macOS 15 及以上、主流 Linux 发行版(Ubuntu 22.04/24.04、Fedora 42/43、Debian 13 等)都支持。Python 方面,PyCharm 支持 Python 3.9 到 3.15 版本。装 PyCharm 之前先把 Python 装好,并且记得在安装时勾选“Add Python to PATH”——这个勾没打上,后面 PyCharm 可能找不到解释器。
版本怎么选:PyCharm 分社区版(Community)和专业版(Professional)。社区版完全免费、开源,语法高亮、代码补全、调试这些基础功能都有,新手写 Python 完全够用。专业版收费,多了 Web 开发、数据库工具、远程开发这些高级功能。新手直接冲社区版就行,不用纠结。
补充一句:2026 年后的 PyCharm 做了一些调整,安装后默认会送你 30 天专业版试用,试用期结束自动切回社区版的核心功能。不想用试用版的,安装时注意选对版本就行。
② PyCharm 社区版下载与安装步骤
下载:打开浏览器,进入 PyCharm 官网 jetbrains.com/pycharm/download/,选对操作系统(Windows/Mac/Linux),找到“Community Edition”点 Download。下载下来的是一个 .exe 安装包(Windows 为例)。
安装(Windows) :
- 双击下载好的
.exe文件,弹出安装向导后点 Next。 - 勾选“I accept the terms…”同意协议,点 Next。
- 选安装路径。强烈建议改到非系统盘,比如
D:\Software\PyCharm——路径里不要有中文、空格或特殊字符。 - 勾选附加选项。新手建议全勾上:
- Create Desktop Shortcut:桌面建快捷方式
- Add launchers dir to PATH:加环境变量,以后命令行也能启动
- Associate .py files:关联
.py文件,双击直接用 PyCharm 打开 - Add “Open Folder as Project”:右键文件夹可以直接当项目打开
- 点 Next 继续,再点 Install,等进度条走完(一两分钟)。
- 安装完成勾选 Run PyCharm Community Edition,点 Finish 启动。
macOS 用户下载
.dmg文件拖到 Applications 就行;Linux 用户下载.tar.gz解压后运行bin/pycharm.sh。
③ 首次启动配置与解释器绑定
第一次打开 PyCharm,会看到一个配置向导:
- 导入设置:选 Do not import settings → OK(新电脑没有旧配置可以导入)。
- 选主题:Darcula(深色护眼)或 Light(浅色)→ Next。
- 插件:新手先跳过,后面需要再装 → Start using PyCharm。
- 激活:社区版直接免费用,不用激活码。
绑定 Python 解释器:解释器就是 PyCharm 用来执行 Python 代码的那个“引擎”。如果电脑上已经装了 Python,PyCharm 通常能自动识别。如果没识别到,手动配置也不难:
- 打开 File → Settings(快捷键
Ctrl+Alt+S) - 左侧找到 Project → Python Interpreter
- 点齿轮图标 → Add… → 选 System Interpreter
- 浏览到 Python 安装目录下的
python.exe(Windows)或python3(macOS/Linux)
如果还没装 Python,PyCharm 会提示你下载安装,按提示操作就行。
④ 创建第一个 Python 项目流程
配置好之后,来建第一个项目:
- 在欢迎界面点 New Project;如果已经打开了项目,点菜单 File → New Project。
- 在 Location 那里选一个文件夹放项目(比如
D:\PythonProject\my_first_project)。 - 项目名称会自动根据文件夹名生成。
- 解释器那里,默认选 Project venv 就行——PyCharm 会为这个项目自动创建一个虚拟环境,把依赖隔离开。
- 点 Create,项目就建好了。
新建 Python 文件并写代码:
- 在左侧项目窗口里,右键点击项目根目录。
- 选 New → Python File。
- 输入文件名,比如
hello,回车。 - 在打开的编辑器里输入:
print("Hello PyCharm!") - 右键编辑区空白处,选 Run ‘hello’,或者点右上角的绿色三角按钮。
- 下方控制台如果输出了
Hello PyCharm!,说明一切正常。
⑤ 编写运行代码与结果验证
写代码的时候,PyCharm 会实时检查语法错误。编辑器右上角有个小指示灯:
- 🟢 绿色:一切正常
- 🟡 黄色:有点小问题(不影响运行)
- 🔴 红色:有严重错误,跑不起来
运行代码有三种方式:
- 点编辑器右上角的绿色三角按钮
- 右键编辑区选 Run ‘文件名’
- 快捷键
Ctrl+Shift+F10(运行当前文件)
运行结果会显示在底部的 Run 工具窗口里。如果报错,看红色的错误信息——PyCharm 会把出错的行号标出来,点一下就能跳到对应位置。
⑥ 常用快捷键与界面布局优化
记住这几个快捷键,日常写代码能顺手很多:
| 快捷键 | 作用 |
|---|---|
Ctrl+Alt+S |
打开设置 |
Ctrl+Shift+F12 |
最大化编辑器(隐藏所有工具窗口) |
Alt+1 |
开关项目文件窗口 |
Ctrl+Tab |
在最近打开的文件间快速切换 |
Ctrl+E |
显示最近打开的文件列表 |
Ctrl+/ |
注释/取消注释当前行 |
Shift+Esc |
关闭当前工具窗口 |
界面布局优化:
- 调整字体大小:File → Settings → Editor → Font,推荐 Consolas 或 Fira Code,大小 14-16px。
- 切换主题:File → Settings → Appearance & Behavior → Appearance。
- 如果屏幕比较小,可以开启紧凑模式(Compact Mode):View → Appearance → Compact Mode,工具栏和图标都会变小。
⑦ 插件安装与功能扩展方法
插件能给 PyCharm 加各种新功能。安装方法:
- 按
Ctrl+Alt+S打开设置 - 左侧选 Plugins
- 点 Marketplace 选项卡
- 搜索框输入插件名字
- 找到后点 Install
- 重启 PyCharm 让插件生效
新手推荐的插件:
- Rainbow Brackets:不同层级的括号显示不同颜色,嵌套多了不容易看花眼
- Key Promoter X:你点了某个菜单操作时,它会提示对应的快捷键,帮你慢慢记住快捷键
- String Manipulation:字符串处理工具,大小写转换、排序什么的很方便
- Translation:选中文本右键直接翻译,看英文注释方便
⑧ 虚拟环境管理与依赖安装
虚拟环境就是个隔离的小房间,每个项目的第三方库装在自己房间里,互相不干扰。
创建虚拟环境:新建项目时选 Project venv,PyCharm 会自动创建。如果项目已经建好了,也可以后补:
- File → Settings → Project → Python Interpreter
- 点齿轮图标 → Add… → 选 Virtualenv Environment
- 指定路径(比如项目根目录下的
.venv)和基础 Python 版本,点 OK
安装第三方库有两种方式:
- 图形界面:在 Python Interpreter 设置里点 + 号,搜索库名(比如
requests),选版本点 Install Package - 终端:点底部 Terminal,直接敲
pip install requests
用 requirements.txt 管理依赖:项目依赖多了之后,用这个文件统一管理:
- 导出当前环境所有依赖:终端里运行
pip freeze > requirements.txt - 别人拿到项目后安装所有依赖:
pip install -r requirements.txt
⑨ 常见启动报错与解决思路
新手遇到最多的几个问题:
1. 安装失败 / 安装包打不开
- 关掉 360、电脑管家这类安全软件再装
- 右键安装包选“以管理员身份运行”
2. 找不到 Python 解释器
- 先确认 Python 装好了,终端里敲
python --version看看有没有输出版本号 - 如果没输出,说明没加到 PATH。重装 Python,安装时勾选“Add Python to PATH”
3. PyCharm 打不开 / 闪退 / 卡死
- 删掉缓存目录试试。Windows 在
C:\Users\你的用户名\.PyCharm<版本> - 如果装了太多第三方插件,试试禁用所有插件启动
- 还不行就卸载重装最新版
4. 控制台报错“Failed to start PowerShell.exe”
- Settings → Tools → Terminal,把 Shell Path 改成
cmd.exe的路径
⑩ 调试模式入门与断点使用技巧
调试就是让代码一步一步走,你可以随时停下来看每个变量的值,找出 bug 在哪里。
基础调试流程:
- 设断点:在代码左侧的行号旁边点一下,会出现一个红色圆点。
- 启动调试:点右上角的绿色小虫子图标,或者菜单 Run → Debug,或者快捷键
Shift+F9。 - 程序停在断点处,底部弹出 Debug 窗口。
- 控制执行:
F8(Step Over):执行当前行,不进入函数内部F7(Step Into):进入当前行调用的函数内部Shift+F8(Step Out):执行完当前函数,回到调用处F9(Resume):继续运行到下一个断点或程序结束
- 查看变量:Debug 窗口的 Variables 面板能看到所有变量的当前值
进阶技巧:
- 条件断点:右键红色断点 → Edit Breakpoint → 在 Condition 里写条件(比如
i == 10),只有条件成立时才停——调试循环时特别好用 - 日志断点:不暂停程序,只在命中时打印日志。右键断点写 Log message,支持
$变量名$占位符 - 运行到光标处:
Alt+F9,程序直接跑到光标所在行停下来
调试这事多练几次就熟了,遇到 bug 别慌,断点一打、F8 一按,问题出在哪一目了然。
更多推荐



所有评论(0)