PyCharm 2025.2 Help

创建并运行您的第一个项目

在开始之前

确保满足以下先决条件:

  • 您已安装 Python。 如果您使用的是 macOS 或 Linux,您的计算机已经安装了 Python。 您可以从 python.org 获取 Python。

要开始使用 PyCharm,让我们编写一个 Python 脚本。

创建一个 Python 项目

  1. 如果您在 欢迎屏幕 上,请点击 新项目。 如果您已经打开了任何项目,请从主菜单中选择 文件 | 新建项目

  2. 尽管您可以在 PyCharm 中创建各种类型的项目,但在本教程中,我们将创建一个简单的 纯 Python 项目。 此模板将创建一个空项目。

    创建新项目
  3. 选择项目位置。 点击 "浏览" 按钮 ,在 位置 字段中指定项目的目录。

    项目名称将自动从指定路径中的文件夹名称派生。

  4. Python 的最佳实践是为每个项目创建一个专用环境。 在大多数情况下,默认的 项目venv 即可满足需求,您无需进行任何配置。

    不过,您仍然可以切换到 自定义环境 ,以便使用现有环境、选择其他环境类型、指定环境位置并修改其他选项。

    新 Python 项目的自定义环境选项

    有关更多信息,请参见 配置 Python 解释器

    目前,让我们保持默认的 项目venv 选项。

  5. 准备好后,请点击 创建

如果您已经打开了一个项目,点击 创建 后,PyCharm 会询问您是要在当前窗口中打开新项目还是在新窗口中打开。 选择 在当前窗口中打开 - 这将关闭当前项目,但您可以稍后重新打开它。

欲了解更多信息,请参阅 打开、重新打开和关闭项目

创建一个 Python 文件

  1. 项目 工具窗口中,选择 项目根目录 (通常是项目树中的根节点),右键点击它,然后选择 文件 | 新建 ...

    创建一个 Python 文件
  2. 从上下文菜单中选择选项 Python 文件 ,然后输入新文件名。

    创建一个新的 Python 文件

    PyCharm 会创建一个新的 Python 文件并将其打开以供编辑。

    新建 Python 文件

编辑 Python 代码

让我们开始编辑您刚刚创建的 Python 文件。

  1. 从声明一个类开始。 当您开始输入时,PyCharm 会建议如何完成您的代码行:

    创建类补全

    选择关键字 class 并输入类名, Car

  2. PyCharm 通知您文件中存在错误:

    创建类分析

    请注意,PyCharm 会即时分析您的代码,结果会立即显示在编辑器右上角的检查指示器中。

    此检查指示器的工作方式类似于交通信号灯:绿色表示一切正常,您可以继续编写代码;黄色表示存在一些小问题,但不会影响编译;红色表示存在严重错误。

    点击它以在 问题 工具窗口中预览详细信息。 缺少一个冒号,然后需要一个缩进:

    查看代码问题
  3. 让我们继续为类创建 __init__ 函数:当您开始输入函数名称时,PyCharm 会建议粘贴整个代码结构,包括必需的 self 参数、右括号和冒号:

    创建类
  4. 如果在编辑代码时注意到任何检查警告,请点击灯泡符号以预览可能的修复和推荐操作列表:

    意图操作
  5. 让我们复制并粘贴整个代码示例。 将鼠标悬停在下面代码块的右上角,点击复制图标,然后将代码粘贴到 PyCharm 编辑器中,替换 Car.py 文件的内容:

    class Car: def __init__(self, speed=0): self.speed = speed self.odometer = 0 self.time = 0 def accelerate(self): self.speed += 5 def brake(self): self.speed -= 5 def step(self): self.odometer += self.speed self.time += 1 def average_speed(self): return self.odometer / self.time if __name__ == '__main__': my_car = Car() print("I'm a car!") while True: action = input("What should I do? [A]ccelerate, [B]rake, " "show [O]dometer, or show average [S]peed?").upper() if action not in "ABOS" or len(action) != 1: print("I don't know how to do that") continue if action == 'A': my_car.accelerate() print("Accelerating...") elif action == 'B': my_car.brake() print("Braking...") elif action == 'O': print("The car has driven {} kilometers".format(my_car.odometer)) elif action == 'S': print("The car's average speed was {} kph".format(my_car.average_speed())) my_car.step()

此时,您已经准备好在 PyCharm 中运行您的第一个 Python 应用了。

运行您的应用程序

使用以下任一方式运行您的代码:

  • 右键点击编辑器,然后从上下文菜单中选择 运行 'Car'

  • 按下 Ctrl+Shift+F10

  • 由于此 Python 脚本包含一个主函数,您可以点击位于边距中的

    您将看到可用命令的弹出菜单。 选择 运行 'Car'

    运行命令

PyCharm 在 运行工具窗口 中执行您的代码。

运行工具窗口

在这里,您可以输入预期值并预览脚本输出。

请注意,PyCharm 为 汽车 文件创建了一个临时的 运行/调试 配置。

临时运行/调试配置

运行/调试配置定义了 PyCharm 执行代码的方式。 您可以将其保存为 永久 配置或修改其参数。 有关运行 Python 代码的更多信息,请参阅 运行/调试配置

摘要

恭喜您完成了在 PyCharm 中的第一个脚本! 让我们回顾一下您在 PyCharm 的帮助下完成的内容:

  • 创建了一个项目。

  • 在项目中创建了一个文件。

  • 创建了源代码。

  • 运行了该源代码。

下一步, 学习如何在 PyCharm 中调试您的程序

最后修改日期: 2025年 9月 26日