Flask本身不提供博客功能，需自行搭建骨架：用文件系统存Markdown文章、bleach安全渲染、url_for管理静态资源与路由，避免数据库依赖以提升开发效率。
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> 或 <iframe></iframe>。必须过滤 HTML 标签，但又得保留 <h2></h2>、<pre class="brush:php;toolbar:false;"></code>、<code><code></code> 这类排版标签。</p>
<p>推荐组合：</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p>
<ul>
<li><code>markdown</code> 解析成 HTML</li>
<li><code>bleach.clean()</code> 白名单过滤，只留 <code>['h1','h2','h3','p','a','code','pre','ul','ol','li']</code> 等安全标签</li>
<li>用 <code>bleach.linkify()</code> 自动把纯文本 URL 转成可点击链接</li>
</ul>
<p>示例片段：</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill11458" title="librosa Python 音频与音乐分析库"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d79f23518.jpg" alt="librosa Python 音频与音乐分析库" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill11458" title="librosa Python 音频与音乐分析库">librosa Python 音频与音乐分析库</a>
<p>librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。</p>
</div>
<a href="/xiazai/skill11458" title="librosa Python 音频与音乐分析库" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<pre class='brush:python;toolbar:false;'>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']}
)
</pre>
<h3>静态资源别硬编码路径，用 url_for()</h3>
<p>开发时把 CSS 放 <code>static/css/style.css，HTML 里写 <link rel="stylesheet" href="/static/css/style.css"> 看似没问题，但一旦加了反向代理或部署到子路径（如 /blog/），路径就全挂。
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 干扰。
