Flask开发问题求助：url_for()失效与模板继承标签异常

问题1：url_for()函数失效 #

排查与修复要点 #

• 模板未被Jinja2解析：如果页面上直接显示{{ url_for(...) }}这类代码，说明Flask没启用模板引擎解析。要确保：
  • 模板文件放在项目根目录的templates文件夹下，后缀为.html。
  • 视图函数用render_template()渲染模板，别直接返回文件内容。示例：

    from flask import render_template
    
    @app.route('/')
    def home():
        return render_template('home.html')
    

• 路由函数名不匹配：url_for("home")里的home必须和你定义的路由函数名完全一致，不是URL路径。比如路由要这么写：

  @app.route('/home-page')
  def home():  # 函数名是home，对应url_for("home")
      return "首页内容"
  

• 静态文件路径错误：调用url_for('static', filename='css/main.css')时，要确认static/css/main.css文件确实存在，目录结构如下：

  你的项目/
  ├── app.py
  ├── templates/
  │   └── layout.html
  └── static/
      └── css/
          └── main.css
  

问题2：模板继承失效，block标签显示纯文本 #

核心修复步骤 #

这种情况本质是Jinja2没解析模板标签，按以下步骤排查：

1. 检查文件扩展名：父模板layout.html和子模板都必须用.html后缀，别用.txt或其他格式。
2. extends路径要正确：子模板里的{% extends "layout.html" %}要确保layout.html在templates目录下，要是在子目录里，就得写相对路径，比如{% extends "layouts/layout.html" %}。
3. 必须用render_template渲染：视图函数里不能直接返回模板文件内容，一定要用render_template()加载子模板：

   @app.route('/about')
   def about():
       return render_template('about.html')
   

4. extends必须是子模板第一行：子模板的{% extends %}指令前面不能有任何内容，包括空格、换行、HTML注释，否则继承会失效。正确写法：

   {% extends "layout.html" %}
   {% block content %}
   <div class="about">
       <h1>My About page</h1>
       <p>This is a test website.</p>
   </div>
   {% endblock %}
   

内容的提问来源于stack exchange，提问作者S. Omar Farooque