Python 毕设选题与原型落地指南

配置别硬编码

app/core/config.py 可以这样写：

from pydantic_settings import BaseSettings
from typing import Optional

class Settings(BaseSettings):
    PROJECT_NAME: str = "学生信息管理系统 API"
    API_V1_STR: str = "/api/v1"
    DATABASE_URL: Optional[str] = None
    SECRET_KEY: str = "your-secret-key-please-change-in-production"

    class Config:
        env_file = ".env"

settings = Settings()

项目根目录放一个 .env，并记得加进 .gitignore：

DATABASE_URL=sqlite:///./test.db
SECRET_KEY=your-real-secret-key-here

路由写法保持克制

app/api/v1/endpoints/students.py 可以这样组织：

from fastapi import APIRouter, Depends, HTTPException
from sqlalchemy.orm import Session
from typing import List
from app.core.database import get_db
from app.models.student import StudentCreate, StudentResponse
from app.crud import student as student_crud

router = APIRouter()

@router.get("/students/", response_model=List[StudentResponse])
def read_students(
    skip: int = 0,
    limit: int = 100,
    db: Session = Depends(get_db)
) -> List[StudentResponse]:
    """
    获取学生列表。
    - **skip**: 跳过的记录数，用于分页。
    - **limit**: 返回的最大记录数。
    """
    students = student_crud.get_students(db, skip=skip, limit=limit)
    return students

@router.post("/students/", response_model=StudentResponse, status_code=201)
def create_student(
    *,
    db: Session = Depends(get_db),
    student_in: StudentCreate
) -> StudentResponse:
    """
    创建一名新学生。
    - 请求体中需包含学生的必要信息（如姓名、学号）。
    """
    student = student_crud.create_student(db=db, student=student_in)
    return student

依赖版本要固定

requirements/base.txt 里至少把核心依赖写清楚：

fastapi==0.104.1
uvicorn[standard]==0.24.0
sqlalchemy==2.0.23
pydantic==2.5.0
pydantic-settings==2.1.0
python-dotenv==1.0.0

安装就用：pip install -r requirements/base.txt

交付时最容易被忽略的几件事

项目能不能顺利演示，往往卡在这些基础项上。

• 部署方式要简单：Docker 很值。Dockerfile 和 docker-compose.yml 写好后，换台机器也能直接起，不用现场补环境。
• 密码和密钥别乱放：涉及用户密码就做哈希存储，别明文。passlib 的 CryptContext 就够用。密钥、连接串都放到环境变量里。
• 输入校验要做实：Pydantic 不是摆设，能挡掉很多脏数据。Web 项目里，ORM 也能减少一部分 SQL 注入风险。
• 启动时别做重活：大模型、重文件、昂贵初始化尽量别放在全局。能懒加载就懒加载，不然启动慢得很明显。
• 日志要有：出错时至少能看出问题从哪儿来的。没有日志，排障基本靠猜。

这些低级错误，最好在提交前清掉

• 把数据库地址、API 地址、绝对路径、密钥全写死在代码里。
• 只会 print，没有 try...except 和日志。
• 所有代码都挤在 main.py 里。
• 依赖版本不固定，requirements.txt 只是个摆设。
• 忘了配 .gitignore，把 venv/、__pycache__/、.env、数据库文件全提交上去。
• 假设运行环境永远完美，目录一定存在，包版本一定一致。

这些问题不难改，但很容易在最后一周被忽略。

结语

毕业设计真正考的是你能不能把一个想法落成可运行、可解释、可演示的东西。Python 只是工具，关键还是结构、配置、依赖、异常处理这些基础功。

如果你现在的项目还很散，先别急着加新功能。把配置拆出来，把模块分开，把依赖固定住，再补几个关键测试，项目面貌通常会立刻好看很多。