#!/usr/bin/env python3 """ 03 - Flask 实战：个人博客系统一个完整的个人博客应用，包含： 1. 文章列表展示（按时间倒序） 2. 文章详情查看（Markdown 风格内容） 3. 发布新文章（表单提交） 4. 删除文章 5. 文章搜索 6. 用户友好的界面运行方式： python3 03-blog-app.py 然后在浏览器访问： - http://localhost:5000/ —— 首页文章列表 - http://localhost:5000/create —— 发布新文章 - http://localhost:5000/post/1 —— 查看文章详情技术要点： - 用列表模拟数据库（后续会用真正数据库替代） - 模板继承实现统一布局 - GET/POST 双方法处理表单 - 动态路由捕获文章 ID - 查询参数实现搜索功能 """ from flask import ( Flask, render_template_string, request, redirect, url_for, abort, flash ) from datetime import datetime import html # HTML 转义，防止 XSS 攻击 # ============================================================ # 数据层（模拟数据库） # ============================================================ # 用 Python 列表存储文章数据 # 后续会替换为 SQLAlchemy + 数据库 POSTS = [ { 'id': 1, 'title': 'Flask 入门指南', 'content': '''

Flask 是一个轻量级的 Python Web 框架，适合快速开发 Web 应用。

它的核心设计哲学是：微框架——只提供最基本的功能，其他功能通过扩展来添加。

为什么选择 Flask？

轻量：核心代码只有几千行
灵活：不受框架约束，你可以自由选择组件
易学：半小时就能上手
文档优秀：官方文档清晰详细

如果你刚开始学习 Python Web 开发，Flask 是绝佳的起点！

通过 Flask，你可以快速理解 HTTP 请求-响应模型、模板引擎、路由系统等 Web 开发的核心概念。

''', 'author': '学习官', 'created_at': '2026-07-13 08:00:00', }, { 'id': 2, 'title': 'Python 3.13 新特性一览', 'content': '''

Python 3.13 带来了许多激动人心的新特性，让我们一探究竟：

主要新特性

改进的交互式解释器：支持多行编辑、语法高亮
JIT 编译器的实验性支持：性能提升
类型系统增强：TypeVar 默认行为改进
错误信息优化：更友好的错误提示

这些改进让 Python 在保持易用性的同时，性能和开发体验不断提升。

''', 'author': '技术小编', 'created_at': '2026-07-12 16:30:00', }, { 'id': 3, 'title': '理解 HTTP 协议', 'content': '''

HTTP（超文本传输协议）是 Web 的基石。无论你使用什么框架，理解 HTTP 都是 Web 开发的基本功。

核心概念

请求-响应模型：客户端发请求，服务器回响应
无状态：每次请求都是独立的
方法：GET（获取）、POST（创建）、PUT（更新）、DELETE（删除）
状态码：200（成功）、404（未找到）、500（服务器错误）

掌握 HTTP 后，你再学任何 Web 框架都会事半功倍！

''', 'author': '网络专家', 'created_at': '2026-07-11 10:15:00', }, ] # 自增 ID 计数器 _next_id = len(POSTS) + 1 # ============================================================ # 模板定义 # ============================================================ # 父模板：全局布局 BASE_TEMPLATE = ''' {% block title %}我的博客{% endblock %}

{% with messages = get_flashed_messages(with_categories=true) %} {% if messages %} {% for category, message in messages %}

{% endfor %} {% endif %} {% endwith %} {% block content %}{% endblock %}

''' # ============================================================ # Flask 应用 # ============================================================ app = Flask(__name__) app.config['SECRET_KEY'] = 'blog-secret-key-dev' app.config['JSON_AS_ASCII'] = False # ============================================================ # 路由：首页 — 文章列表 # ============================================================ @app.route('/') def index(): """ 首页：显示所有文章（支持搜索过滤）搜索功能：?q=关键词 - 按标题和作者搜索 - 不区分大小写 - 没有结果时显示友好的空状态 """ query = request.args.get('q', '').strip() # 按创建时间倒序排列 posts = sorted(POSTS, key=lambda p: p['created_at'], reverse=True) # 如果有搜索关键词，过滤文章 if query: query_lower = query.lower() posts = [ p for p in posts if query_lower in p['title'].lower() or query_lower in p['author'].lower() or query_lower in p['content'].lower() ] return render_template_string('''{% extends "base" %} {% block title %}{{ "搜索: " + query if query else "首页" }} - 我的博客{% endblock %} {% block content %}

{% if query %} 搜索结果：{{ query }}（{{ posts|length }} 篇） {% else %} 最新文章 {% endif %}

{% if posts %} {% for post in posts %}

✍️ {{ post.author }} 📅 {{ post.created_at }}

阅读全文 →

{% endfor %} {% else %}

😕 没有找到文章

{% if query %}

没有匹配 "{{ query }}" 的文章，试试其他关键词？

{% else %}

还没有文章，成为第一位作者吧！

发布第一篇文章 {% endif %}

{% endif %} {% endblock %}''', posts=posts, query=query, ) # ============================================================ # 路由：文章详情 # ============================================================ @app.route('/post/') def show_post(post_id): """ 文章详情页面 - 根据 ID 查找文章 - 不存在则返回 404 """ # 查找文章 post = None for p in POSTS: if p['id'] == post_id: post = p break if post is None: abort(404) return render_template_string('''{% extends "base" %} {% block title %}{{ post.title }} - 我的博客{% endblock %} {% block content %}

✍️ {{ post.author }} 📅 {{ post.created_at }}

← 返回首页

{% endblock %}''', post=post, ) # ============================================================ # 路由：发布文章 # ============================================================ @app.route('/create', methods=['GET', 'POST']) def create(): """ 发布新文章 - GET：显示发布表单 - POST：处理表单提交，创建新文章 """ global _next_id if request.method == 'POST': # 获取表单数据 title = request.form.get('title', '').strip() content = request.form.get('content', '').strip() author = request.form.get('author', '').strip() # 验证数据 errors = [] if not title: errors.append('标题不能为空') if not content: errors.append('内容不能为空') if not author: errors.append('作者不能为空') if errors: for error in errors: flash(error, 'error') return render_template_string(CREATE_TEMPLATE, title=title, content=content, author=author) # 创建新文章 new_post = { 'id': _next_id, 'title': title, 'content': content, 'author': author, 'created_at': datetime.now().strftime('%Y-%m-%d %H:%M:%S'), } POSTS.append(new_post) _next_id += 1 flash('文章发布成功！', 'success') return redirect(url_for('show_post', post_id=new_post['id'])) # GET 请求：显示表单 return render_template_string(CREATE_TEMPLATE, title='', content='', author='') CREATE_TEMPLATE = '''{% extends "base" %} {% block title %}发布文章 - 我的博客{% endblock %} {% block content %}

📝 发布新文章

{% endblock %}''' # ============================================================ # 路由：删除文章 # ============================================================ @app.route('/post//delete', methods=['POST']) def delete_post(post_id): """ 删除文章（POST 请求） - 使用 POST 而不是 GET，防止 CSRF 和误操作 - 删除后重定向到首页 """ global POSTS post_to_delete = None for p in POSTS: if p['id'] == post_id: post_to_delete = p break if post_to_delete is None: abort(404) POSTS.remove(post_to_delete) flash(f'文章 "{post_to_delete["title"]}" 已删除', 'success') return redirect(url_for('index')) # ============================================================ # 错误处理 # ============================================================ @app.errorhandler(404) def not_found(error): return render_template_string('''{% extends "base" %} {% block title %}404 - 页面未找到{% endblock %} {% block content %}

404

页面未找到

您访问的页面不存在

← 返回首页

{% endblock %}'''), 404 # ============================================================ # 🚀 启动应用 # ============================================================ if __name__ == '__main__': print("=" * 50) print("📝 个人博客启动...") print(" 访问: http://127.0.0.1:5000/") print(" 发布: http://127.0.0.1:5000/create") print("=" * 50) print(f"\n当前共有 {len(POSTS)} 篇示例文章") print("按 Ctrl+C 停止服务器\n") app.run(debug=True, host='127.0.0.1', port=5000)