PyCharm 第一个 Python 项目：从零开始的完整指南与丰富代码实例

lideiguo

167人浏览 · 2026-07-15 08:47:06

lideiguo · 2026-07-15 08:47:06 发布

1. PyCharm 简介与环境准备

PyCharm 是 JetBrains 公司推出的一款功能强大的 Python 集成开发环境（IDE），专为 Python 开发者设计，提供了智能代码补全、代码分析、图形化调试器、版本控制集成、项目管理等众多功能，是学习和开发 Python 项目的绝佳工具。

在开始第一个 Python 项目之前，你需要完成以下准备工作：

下载与安装 PyCharm：访问 JetBrains 官网，下载适用于你操作系统的 PyCharm Community（免费版）或 Professional（专业版）版本。
安装 Python 解释器：确保你的系统已安装 Python。可以从 Python 官网下载并安装最新版本。
启动 PyCharm：首次启动时，PyCharm 会引导你进行一些初始设置，如选择主题、配置快捷键方案等，保持默认或根据喜好调整即可。

2. 创建你的第一个 Python 项目

让我们一步步创建一个名为 “HelloPyCharm” 的新项目。

在 PyCharm 欢迎界面，点击 “New Project”。
在 “Location” 字段，输入或浏览到你希望存放项目的目录，并将项目命名为 “HelloPyCharm”。
在 “Python Interpreter” 部分，PyCharm 会自动检测已安装的 Python。你可以选择系统解释器或创建一个新的虚拟环境（推荐，以隔离项目依赖）。
点击 “Create”。PyCharm 将创建项目目录并初始化环境。

项目创建后，你会在左侧的 Project 工具窗口中看到项目结构。右键点击项目根目录，选择 New -> Python File，输入文件名 main.py，然后按回车。

3. 编写并运行第一个 Python 程序

在打开的 main.py 文件中，输入以下经典代码：

# main.py
def say_hello(name):
    """一个简单的问候函数"""
    return f"Hello, {name}! Welcome to PyCharm."

if __name__ == "__main__":
    # 获取用户输入
    user_name = input("Please enter your name: ")
    # 调用函数并打印结果
    greeting = say_hello(user_name)
    print(greeting)
    print("Your first PyCharm program runs successfully!")

运行程序：

右键点击编辑器区域，选择 “Run ‘main’”。
或使用快捷键（默认为 Shift+F10）。

程序运行后，PyCharm 底部的 “Run” 工具窗口会打开。你会看到提示 “Please enter your name:”，输入你的名字（例如 “Alex”）后按回车，将看到输出结果。

Please enter your name: Alex
Hello, Alex! Welcome to PyCharm.
Your first PyCharm program runs successfully!

4. 探索 PyCharm 核心功能与代码实例

4.1 智能代码补全与导航

PyCharm 的智能补全能极大提升编码效率。尝试在 main.py 下方新建一个文件 calculator.py，并输入以下代码：

# calculator.py
class Calculator:
    """一个简单的计算器类"""

    def __init__(self):
        self.memory = 0

    def add(self, a, b):
        """返回两数之和"""
        return a + b

    def subtract(self, a, b):
        """返回两数之差"""
        return a - b

    def multiply(self, a, b):
        """返回两数之积"""
        return a * b

    def divide(self, a, b):
        """返回两数之商，处理除零错误"""
        if b == 0:
            raise ValueError("Cannot divide by zero!")
        return a / b

    def store_to_memory(self, value):
        """存储值到内存"""
        self.memory = value
        print(f"Value {value} stored in memory.")

    def recall_memory(self):
        """从内存召回值"""
        return self.memory

输入 calc = Calculator() 后，输入 calc. 并稍作停顿，PyCharm 会弹出所有可用方法（add, subtract等）的列表，使用方向键或鼠标选择即可自动补全。

4.2 代码重构与调试

重命名重构： 将光标放在 calculator.py 的 Calculator 类名上，右键选择 Refactor -> Rename（或 Shift+F6），将其改为 ScientificCalculator。PyCharm 会自动更新所有引用。

调试实例： 在 divide 方法的 if b == 0: 行左侧单击，设置一个断点（红色圆点）。创建一个新的运行配置来调试：

# debug_demo.py
from calculator import Calculator

calc = Calculator()
print("Testing division...")
try:
    result = calc.divide(10, 2)
    print(f"10 / 2 = {result}")
    result = calc.divide(5, 0)  # 这里会触发断点
    print(f"5 / 0 = {result}")
except ValueError as e:
    print(f"Error: {e}")

右键点击 debug_demo.py，选择 “Debug ‘debug_demo’”。程序会在断点处暂停，你可以在 “Debug” 工具窗口中查看变量值、调用栈，并单步执行（F8）或步入（F7）代码。

4.3 使用版本控制（Git）

PyCharm 内置了强大的 Git 支持。要将项目置于版本控制下：

点击顶部菜单 VCS -> Enable Version Control Integration。
选择 Git 并确认。
项目文件会变成颜色标记（红色未跟踪，绿色已添加）。右键项目根目录，选择 Git -> Commit Directory。
在提交窗口中，勾选要提交的文件，输入提交信息 “Initial commit”，点击 Commit。

5. 进阶实例：构建一个简单的待办事项应用

让我们用 PyCharm 构建一个命令行待办事项应用，综合运用文件操作、异常处理和列表操作。

# todo_app.py
import json
import os

TODO_FILE = "todos.json"

def load_todos():
    """从文件加载待办事项列表"""
    if os.path.exists(TODO_FILE):
        with open(TODO_FILE, 'r', encoding='utf-8') as f:
            return json.load(f)
    return []

def save_todos(todos):
    """保存待办事项列表到文件"""
    with open(TODO_FILE, 'w', encoding='utf-8') as f:
        json.dump(todos, f, ensure_ascii=False, indent=2)

def add_todo(todos):
    """添加一个新的待办事项"""
    title = input("Enter todo title: ")
    todo = {"title": title, "done": False}
    todos.append(todo)
    save_todos(todos)
    print(f"Todo '{title}' added.")

def list_todos(todos):
    """列出所有待办事项"""
    if not todos:
        print("No todos yet.")
        return
    for i, todo in enumerate(todos, 1):
        status = "✓" if todo["done"] else "✗"
        print(f"{i}. [{status}] {todo['title']}")

def mark_done(todos):
    """标记待办事项为完成"""
    list_todos(todos)
    try:
        idx = int(input("Enter the number to mark as done: ")) - 1
        if 0 <= idx < len(todos):
            todos[idx]["done"] = True
            save_todos(todos)
            print("Todo marked as done.")
        else:
            print("Invalid number.")
    except ValueError:
        print("Please enter a valid number.")

def main():
    todos = load_todos()
    while True:
        print("\n--- Todo App ---")
        print("1. Add Todo")
        print("2. List Todos")
        print("3. Mark Todo as Done")
        print("4. Exit")
        choice = input("Choose an option (1-4): ")
        if choice == "1":
            add_todo(todos)
        elif choice == "2":
            list_todos(todos)
        elif choice == "3":
            mark_done(todos)
        elif choice == "4":
            print("Goodbye!")
            break
        else:
            print("Invalid choice. Please try again.")

if __name__ == "__main__":
    main()

运行此程序，你将体验一个完整的交互式应用。PyCharm 会帮助你检查 JSON 语法、函数调用和流程控制。