企业官网建设流程全解析

背景痛点：为什么“炫酷”≠“能过”

每年 3 月，实验室的打印机就开始冒烟：同学们抱着一摞“基于深度学习+区块链+元宇宙”的标书，信心满满地准备改变世界。到了 5 月，却集体在答辩室门口排队删库跑路。
我当年也一样，把毕设当成“技术大杂烩”，结果：

• 把 PyTorch、Vue、Redis、Docker 全堆进去，最后连“登录”都跑不到底；
• 代码全写在main.py，一个文件 3000 行，老师打开后直接劝退；
• 本地跑得好好的，搬到云服务器就 502，日志里只有一行Error: Error。

血泪教训：毕设不是“炫技大会”，而是“工程能力体检”。能跑、能改、能部署，才是及格线。

技术选型：Flask vs Django——别让框架替你写论文

先放结论：
小型毕设、时间紧、人手少 → Flask；
后台功能多、后台管理刚需 → Django。

一句话：想快速出 MVP，用 Flask；想少写后台，用 Django。下文以 Flask 演示，Django 同学把urls.py换成urls.py即可。

核心实现：一个“待办事项”拆给你看

功能一句话：用户注册、登录、增删改查自己的任务。
工程目标：目录清晰、可单元测试、老师能秒懂。

1. 目录先搭好

todo/ ├── app/ │ ├── __init__.py │ ├── models.py │ ├── routes.py │ ├── auth.py │ └── utils.py ├── migrations/ ├── tests/ ├── requirements.txt └── run.py

2. 数据模型（SQLAlchemy）

# app/models.py from datetime import datetime from typing import Optional from flask_sqlalchemy import SQLAlchemy from flask_login import UserMixin db = SQLAlchemy() class User(UserMixin, db.Model): id: int = db.Column(db.Integer, primary_key=True) username: str = db.Column(db.String(64), unique=True, nullable=False) password_hash: str = db.Column(db.String(128), nullable=False) class Task(db.Model): id: int = db.Column(db.Integer, primary_key=True) body: str = db.Column(db.String(200), nullable=False) done: bool = db.Column(db.Boolean, default=False) user_id: int = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False) create_time: datetime = db.Column(db.DateTime, default=datetime.utcnow)

3. 业务逻辑（services 抽离）

# app/utils.py from werkzeug.security import generate_password_hash, check_password_hash def hash_password(plain_pwd: str) -> str: return generate_password_hash(plain_pwd) def verify_password(pwd_hash: str, plain_pwd: str) -> bool: return check_password_hash(pwd_hash, plain_pwd)

4. 路由与视图（只贴关键段）

# app/routes.py from flask import Blueprint, request, jsonify from flask_login import login_required, current_user from app import db from app.models import Task bp = Blueprint('task', __name__, url_prefix='/api') @bp.route('/tasks', methods=['GET']) @login_required def list_tasks(): tasks = Task.query.filter_by(user_id=current_user.id).all() return jsonify([{'id': t.id, 'body': t.body, 'done': t.done} for t in tasks]) @bp.route('/tasks', methods=['POST']) @login_required def add_task(): data = request.get_json() if not data or not data.get('body'): return jsonify({'msg': 'body required'}), 400 t = Task(body=data['body'], user_id=current_user.id) db.session.add(t) db.session.commit() return jsonify({'id': t.id}), 201

5. 启动文件

# run.py from flask import Flask from app import create_app app = create_app('dev') if __name__ == '__main__': app.run()

Clean Code 三件套：

• 类型提示：pyright 不飘红；
• 函数<20 行：一眼看完；
• 注释写“为什么”而不是“是什么”。

部署实践：把“能跑”变成“能上线”

1. 本地先跑通

python -m venv venv source venv/bin/activate pip install -r requirements.txt flask db upgrade python run.py

2. 生产级 WSGI 服务器

pip install gunicorn gunicorn -w 4 -b 0.0.0.0:8000 'app:create_app("prod")'

3. Nginx 反向代理

server { listen 80; server_name your.domain; location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

4. 云服务器 3 步曲

1. 买最便宜的 1C2G，装 Ubuntu 22.04；
2. 开放 22/80/443 端口；
3. 把代码 push 到 GitHub，服务器上git clone一键拉。

SQLite 单文件拷来拷去最省事；想炫技就换 PostgreSQL，记得把SQLALCHEMY_DATABASE_URI写进环境变量。

安全性与性能：别让“小项目”变成“大新闻”

• 密码哈希：已用 Werkzeug，别自己 md5；
• CSRF：Flask-WTF 默认带令牌，前端fetch记得加credentials: 'same-origin'；
• SQL 注入：SQLAlchemy 占位符天生免疫，不要手拼字符串；
• 限速：Flask-Limiter 三行代码防爆破；
• 性能：加条CREATE INDEX idx_task_user ON task(user_id);查询秒提速。

生产环境避坑清单

1. 虚拟环境：永远venv+pip-tools，别全局；
2. 依赖锁定：pip-compile requirements.in > requirements.txt，版本钉死；
3. 日志：logging.config.dictConfig写进文件，别print；
4. 秘钥硬编码：.env+python-dotenv，Git 忽略；
5. 重启策略：Systemd 或者supervisord，服务器掉电能自启；
6. 备份：SQLite 直接scp；PostgreSQL 用pg_dump，定时 crontab。

把课程知识变成工程能力：下一步怎么做？

• 把上面的“待办”拉下来，先跑通；
• 把用户系统换成“邮箱激活”，顺手学 Celery 异步任务；
• 把任务加上“标签”多对多，体验模型关系；
• 把前端拆成 Vue，练一次真正的前后端分离；
• 把单元测试覆盖率拉到 80%，你就拥有了简历亮点。

毕业设计不是句号，而是把“课堂例题”升级为“可维护产品”的第一道门槛。先让代码能跑、能测、能部署，再去谈“分布式”“高并发”。
动手重构你的题目，从“跑起来”到“像回事”，你就领先了 90% 的同学。祝答辩顺利，少掉头发。