PyCharm社区版安装后怎么创建第一个Python项目
针对初学者的PyCharm社区版首次项目创建指南。详解新建项目弹窗配置、虚拟环境原理、代码编写与运行验证,以及首次运行常见报错处理。
安装完成 PyCharm 社区版(PyCharm Community Edition)后,初次打开界面通常会面对一个相对陌生的欢迎窗口。创建一个可用的 Python 项目,核心只包含三件事:确定项目的保存目录、为项目绑定一个有效的 Python 解释器、在项目内新建并运行 .py 脚本文件。本文将按实际操作路径,完整讲解从初次启动到成功输出运行结果的每一个步骤。
一、准备确认:明确 PyCharm 与 Python 的关系
初学者容易产生一个误解,认为安装了 PyCharm 就等于电脑里已经有了 Python。实际上,PyCharm 只是一个集成开发环境(IDE),负责提供代码编辑、高亮提示和调试面板;真正负责执行代码的是 Python 解释器(Python 运行时)。
在创建项目前,请确保系统已提前安装了官方 Python。若尚未安装,可以在终端或命令提示符中输入 python --version 进行验证。如果系统返回了版本号(如 Python 3.10 或更新版本),说明环境完备;如果提示命令未找到,则需要先从 Python 官网下载并完成安装,并在安装选项中勾选“Add python.exe to PATH”。
二、核心操作:新建项目的完整步骤
启动 PyCharm 社区版后,若尚未打开过任何项目,会首先看到“Welcome to PyCharm”欢迎屏幕。创建新项目的主要操作链路如下:
1. 点击“New Project”
在欢迎界面中央或左上角,找到并点击带有加号图标的 New Project 按钮。如果此前已经打开过其他项目,可通过顶部菜单栏点击 File > New Project... 调出相同配置面板。
2. 设置项目路径(Location)
在弹出窗口的顶部,可以看到 Location(位置)输入框。该输入框决定了项目文件夹保存在硬盘的哪个位置。
- 默认路径通常类似于:
C:\Users\用户名\PycharmProjects\pythonProject。 - 末尾的
pythonProject即新建工程的文件名。你可以直接将其修改为具体项目的名称,例如my_first_demo。 - 特别提醒:项目路径中尽量避免包含中文字符、特殊符号或空格。部分第三方依赖库在编译或执行时对非 ASCII 路径兼容性较差,全英文路径可避免后续出现莫名报错。
3. 配置 Python 环境与解释器(Python Interpreter)
项目路径下方是“Interpreter type”或“Environment”设置,这是整个创建过程中最关键的一环。PyCharm 提供了多种环境类型:
- Project venv(推荐):基于系统已装的 Python 自动为当前项目生成一个独立的虚拟环境(Virtualenv)。这样每个项目拥有一套专属的第三方包,不会污染全局 Python,也不会因不同项目的包版本冲突而导致程序崩溃。
- Base Python:系统会自动检测电脑中已安装的 Python 执行文件(如
python.exe)。如果此处为空,点击下拉菜单或右侧的三点图标(Browse),定位到本机安装的python.exe路径。
4. 欢迎脚本选项(Create a welcome script)
在界面底部通常有一个可选复选框:“Create a main.py welcome script”。
- 如果勾选,PyCharm 会自动在工程根目录下生成一个预置了简单示例代码的
main.py文件。 - 如果不勾选,则生成一个完全空白的工程,后续手动新建文件。对于新手,保持默认勾选或自行新建均可。确认无误后,点击右下角的 Create 按钮。
三、项目结构与第一份代码
点击 Create 后,PyCharm 会进入主工作界面,并在底部状态栏显示“Indexing”(建立索引)与虚拟环境初始化进度。初次加载需要数秒至十几秒时间,等待底部进度条走完即可正常操作。
手动新建 Python 脚本文件
如果创建项目时没有勾选生成 main.py,或者需要新增其他模块文件,请按以下步骤操作:
- 在左侧的 Project 工具窗口中,找到并右键点击项目根目录名字(如
my_first_demo)。 - 在弹出的右键菜单中,依次选择 New > Python File。
- 在弹出的命名小窗中输入文件名(例如
hello),按回车确认。PyCharm 会自动补充.py后缀,并在右侧编辑区打开hello.py。
编写示例代码
在打开的编辑区中输入以下代码:
def greet(name):
return f"欢迎使用 PyCharm 社区版,{name}!"
if __name__ == "__main__":
user_name = "开发者"
result = greet(user_name)
print(result)
四、执行代码与查看输出结果
代码编写完成后,需要通知解释器执行该文件。初次运行代码,推荐使用以下两种方式:
- 方法一(最稳妥):右键直接运行
在右侧代码编辑区内任意空白处单击鼠标右键,在菜单中找到带有绿色播放三角图标的选项:Run 'hello'(快捷键为 Windows 下的Ctrl + Shift + F10或 macOS 下的Control + Shift + R)。 - 方法二:行号左侧的绿色箭头
在if __name__ == "__main__":或主逻辑所在行的行号左侧,会显示一个绿色的实心小三角,左键点击它并选择 Run 'hello'。
执行后,界面底部会自动弹出 Run 控制台窗口。如果配置正确,控制台中将打印如下内容:
/Users/user/PycharmProjects/my_first_demo/.venv/bin/python /Users/user/PycharmProjects/my_first_demo/hello.py
欢迎使用 PyCharm 社区版,开发者!
Process finished with exit code 0
控制台最后一行显示的
Process finished with exit code 0 代表程序已完整执行且正常退出,没有触发任何未处理的致命异常(退出码 0 代表成功,非 0 通常代表程序异常中断)。
五、新手创建后常见问题与排查
在第一次创建或运行项目时,最常遇到的问题往往集中在环境识别上。常见情况及处理方法如下:
| 现象 / 报错 | 产生原因 | 解决方法 |
|---|---|---|
| No Python interpreter configured for the project | 创建项目时未关联解释器,或系统 Python 路径被意外移动。 | 点击提示栏右侧的 Configure Python Interpreter,选择已存在的解释器或点击 Add Interpreter 重新指定。 |
| 右键菜单中没有 Run 选项 | 文件后缀不是 .py,或者项目尚在后台“Indexing”索引尚未就绪。 |
确认文件名以 .py 结尾;若界面右下角有进度条在转动,等待索引构建完毕后重试。 |
| 控制台出现中文乱码 | 系统默认编码与 PyCharm 内部终端编码不一致。 | 打开 Settings / Preferences > Editor > File Encodings,将 Global、Project 与 Properties Encoding 均统一设为 UTF-8。 |
完成以上步骤并成功打印输出后,你的第一个 Python 项目即已建立完毕。后续只要在该工程内继续增加 .py 脚本或通过内置终端使用 pip install 安装第三方库,即可稳定开展后续的 Python 开发工作。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









