如何用Python和Flask在2小时内搭建一个个人博客网站-Python教程-PHP中文网

Flask本身不提供博客功能，需自行搭建骨架：用文件系统存Markdown文章、bleach安全渲染、url_for管理静态资源与路由，避免数据库依赖以提升开发效率。

如何用python和flask在2小时内搭建一个个人博客网站

Flask 本身不提供博客功能，得自己搭骨架

Flask 是微框架，没有内置文章管理、用户登录或后台页面。所谓“2小时搭完”，实际是快速实现最小可用闭环：能写 Markdown 文章、按日期列表展示、支持 URL 访问单篇——其余如评论、搜索、分类页都得延后。

关键取舍点：

用 flask-sqlalchemy 存文章太重，初期直接读取 posts/ 目录下的 .md 文件更轻快
不接数据库就不用配连接、迁移、ORM 模型，省掉至少 40 分钟调试时间
所有文章用文件名控制发布时间（如 2024-03-15-my-first-post.md），避免手动填字段

用 python-markdown + bleach 做安全渲染

直接 markdown.markdown() 渲染用户写的 Markdown 有 XSS 风险——比如文中嵌了 <script></script> 或。必须过滤 HTML 标签，但又得保留

、、 这类排版标签。

推荐组合：

markdown 解析成 HTML
bleach.clean() 白名单过滤，只留 ['h1','h2','h3','p','a','code','pre','ul','ol','li'] 等安全标签
用 bleach.linkify() 自动把纯文本 URL 转成可点击链接

示例片段：

import markdown
import bleach

def render_markdown(text):
    html = markdown.markdown(text, extensions=['fenced_code', 'codehilite'])
    return bleach.clean(
        html,
        tags=['h1','h2','h3','p','a','code','pre','ul','ol','li'],
        attributes={'a': ['href']}
    )

静态资源别硬编码路径，用 url_for()

开发时把 CSS 放 static/css/style.css，HTML 里写看似没问题，但一旦加了反向代理或部署到子路径（如 /blog/），路径就全挂。

librosa Python 音频与音乐分析库

librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。

下载

Flask 的 url_for() 会自动适配当前配置：

url_for('static', filename='css/style.css') → 返回正确路径
连文章页链接也该用 url_for('post', slug='my-first-post')，而不是拼字符串
模板里写 {{ url_for('static', filename='js/main.js') }}，别手敲 /static/...

本地预览没问题，部署后 404？检查 static 路由和文件权限

常见现象：开发时图片能显示，上线后全变 404；或者 style.css 返回 404 但路径明明对。不是代码问题，是部署环境限制。

重点排查：

确认 static/ 目录在服务器上真实存在，且 Flask 进程有读取权限（尤其用 gunicorn 启动时工作目录可能不是项目根）
如果用 Nginx 反代，确保没屏蔽 /static/ 路径（Nginx 配置里要有 location /static { alias /path/to/your/static/; }）
Flask 默认只服务 static/ 和 templates/，别把文章文件夹（如 posts/）放错位置——它不该被 Web 服务器直接访问，而应由 Python 读取

最省事的验证方式：在视图函数里加一行 print(os.listdir('static/css'))，看能否列出文件。

真要卡在部署环节，优先用 flask run --host=0.0.0.0 --port=8000 直接暴露端口测通，排除 Nginx 干扰。