背景介绍

Flask‌作为Python轻量级Web框架，凭借其灵活性和简洁性，成为搭建个性化博客的首选。本文将通过300行核心代码，手把手教你实现支持Markdown渲染、文章管理、分类标签、评论功能的个人博客系统，并提供Docker一键部署方案，‌技术栈清晰，二次开发成本极低‌！

---

一、项目目标与技术选型

‌核心功能‌

1. 文章发布与管理（增删改查）
2. Markdown语法支持 + 代码高亮
3. 文章分类与标签系统
4. 用户评论与审核功能
5. 响应式布局（适配PC/手机）

‌技术方案‌

• ‌后端框架‌：Flask 3.0 + Flask-SQLAlchemy（ORM）
• ‌前端模板‌：Jinja2 + Bootstrap 5
• ‌Markdown渲染‌：mistune + Pygments（代码高亮）
• ‌部署方案‌：Docker + Gunicorn + Nginx

---

二、项目结构设计

myblog/  
├── app/  
│   ├── templates/          # 前端模板  
│   │   ├── index.html      # 首页  
│   │   ├── post.html       # 文章详情页  
│   │   └── admin/          # 后台管理  
│   ├── static/             # 静态资源  
│   ├── models.py           # 数据模型  
│   ├── routes.py           # 路由逻辑  
│   └── __init__.py  
├── config.py               # 配置文件  
├── requirements.txt        # 依赖库  
└── docker-compose.yml      # Docker部署配置  

三、核心代码实现与解析

‌1. Flask应用初始化（app/init.py）

from flask import Flask  
from flask_sqlalchemy import SQLAlchemy  

db = SQLAlchemy()  

def create_app():  
    app = Flask(__name__)  
    app.config.from_pyfile('../config.py')  # 加载配置  

    db.init_app(app)  
    
    # 注册蓝图  
    from app.routes import main, admin  
    app.register_blueprint(main)  
    app.register_blueprint(admin, url_prefix='/admin')  

    return app  

‌2. 数据模型设计（app/models.py）

from datetime import datetime  
from app import db  

class Post(db.Model):  
    id = db.Column(db.Integer, primary_key=True)  
    title = db.Column(db.String(120), nullable=False)  
    content = db.Column(db.Text, nullable=False)  
    created_at = db.Column(db.DateTime, default=datetime.utcnow)  
    category_id = db.Column(db.Integer, db.ForeignKey('category.id'))  
    tags = db.relationship('Tag', secondary='post_tag', backref='posts')  

class Category(db.Model):  
    id = db.Column(db.Integer, primary_key=True)  
    name = db.Column(db.String(50), unique=True)  

class Tag(db.Model):  
    id = db.Column(db.Integer, primary_key=True)  
    name = db.Column(db.String(30), unique=True)  

# 多对多关系表  
post_tag = db.Table('post_tag',  
    db.Column('post_id', db.Integer, db.ForeignKey('post.id')),  
    db.Column('tag_id', db.Integer, db.ForeignKey('tag.id'))  
)  

‌3. Markdown渲染与代码高亮（app/util.py）

import mistune  
from pygments import highlight  
from pygments.lexers import get_lexer_by_name  
from pygments.formatters import HtmlFormatter  

class HighlightRenderer(mistune.HTMLRenderer):  
    def block_code(self, code, lang=None):  
        if lang:  
            lexer = get_lexer_by_name(lang, stripall=True)  
            formatter = HtmlFormatter()  
            return highlight(code, lexer, formatter)  
        return f'<pre><code>{mistune.escape(code)}</code></pre>'  

markdown = mistune.create_markdown(renderer=HighlightRenderer())  

‌4. 文章详情页路由（app/routes.py）

from flask import Blueprint, render_template  
from app.models import Post  
from app.util import markdown  

main = Blueprint('main', __name__)  

@main.route('/post/<int:post_id>')  
def show_post(post_id):  
    post = Post.query.get_or_404(post_id)  
    # 将Markdown转为HTML  
    post.content = markdown(post.content)  
    return render_template('post.html', post=post)  

四、实战案例演示

‌场景1：发布一篇技术文章‌

1. 后台录入Markdown内容：```

   如何优化Python代码性能？

   def fibonacci(n):  
       a, b = 0, 1  
       for _ in range(n):  
           yield a  
           a, b = b, a + b  
   
   

2. 前端自动渲染为带高亮的HTML页面。

---

‌场景2：添加Docker部署支持‌

在docker-compose.yml中定义服务：

services:  
  web:  
    build: .  
    ports:  
      - "8000:8000"  
    command: gunicorn --bind 0.0.0.0:8000 -w 4 "app:create_app()"  
    depends_on:  
      - db  
  db:  
    image: postgres:13  
    environment:  
      POSTGRES_PASSWORD: mysecretpassword  

五、避坑指南

1. ‌数据库迁移问题‌：

   • 使用Flask-Migrate管理模型变更：```
     flask db init flask db migrate flask db upgrade

2. ‌调试模式安全隐患‌：

   • 生产环境务必设置DEBUG=False，避免敏感信息泄露

3. ‌静态文件缓存‌：

   • 在Nginx配置中添加版本号避免缓存：/static/css/style.css?v=1.0

---

六、总结与扩展

本文实现了一个‌高定制性‌的Flask博客系统，核心代码仅300行，却覆盖了从开发到部署的全流程。读者可在此基础上扩展以下功能：

1. ‌SEO优化‌：添加sitemap生成、meta标签自动填充
2. ‌访问统计‌：集成Google Analytics或Matomo
3. ‌全文搜索‌：使用Elasticsearch实现文章检索
4. ‌用户系统‌：增加OAuth2第三方登录（GitHub/微信）