PyCharm社区版安装后怎么创建第一个Python项目

阿澈
阿澈
发布时间:2026-11-18 | 6人浏览过
原创

针对初学者的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社区版安装后怎么创建第一个Python项目
图 1:PyCharm 客户端与 Python 解释器的分工与协同关系

二、核心操作:新建项目的完整步骤

启动 PyCharm 社区版后,若尚未打开过任何项目,会首先看到“Welcome to PyCharm”欢迎屏幕。创建新项目的主要操作链路如下:

PyCharm社区版安装后怎么创建第一个Python项目
图 2:在欢迎界面新建 Python 项目的四个核心步骤

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”(建立索引)与虚拟环境初始化进度。初次加载需要数秒至十几秒时间,等待底部进度条走完即可正常操作。

PyCharm社区版安装后怎么创建第一个Python项目
图 3:PyCharm 新建工程后的经典工作目录分布

手动新建 Python 脚本文件

如果创建项目时没有勾选生成 main.py,或者需要新增其他模块文件,请按以下步骤操作:

  1. 在左侧的 Project 工具窗口中,找到并右键点击项目根目录名字(如 my_first_demo)。
  2. 在弹出的右键菜单中,依次选择 New > Python File。
  3. 在弹出的命名小窗中输入文件名(例如 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。
PyCharm社区版安装后怎么创建第一个Python项目
图 4:创建首个 Python 项目的核心检查清单

完成以上步骤并成功打印输出后,你的第一个 Python 项目即已建立完毕。后续只要在该工程内继续增加 .py 脚本或通过内置终端使用 pip install 安装第三方库,即可稳定开展后续的 Python 开发工作。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表