App Flask lớn dần, template và file tĩnh dồn vào templates/ và static/ ở gốc sẽ nhanh chóng rối: hai module dễ trùng tên index.html hay style.css, và tách một module sang dự án khác thì template đi kèm bị bỏ lại. Cách gọn nhất: khai báo template_folder và static_folder khi tạo Blueprint để mỗi module tự mang theo template và file tĩnh riêng.
Vấn đề
Giả sử app có hai Blueprint — admin và shop — đều cần trang index.html. Không tách thư mục, cả hai file phải nằm chung trong templates/, mà chỉ một file được mang tên đó. Cách chữa cháy thường thấy là đặt tên dài kiểu admin_index.html, shop_index.html: càng nhiều module, tên file càng dài, càng khó đoán file nào của module nào. File tĩnh cũng vậy: static/style.css không cho biết đó là CSS của trang quản trị hay cửa hàng, và khi mang module admin sang dự án khác, bạn phải mò lại từng file rải rác trong thư mục chung.
# app.py — mọi template dồn vào templates/ ở gốcadmin = Blueprint("admin", __name__)shop = Blueprint("shop", __name__)@admin.route("/")def admin_index(): return render_template("index.html") # của admin hay shop?@shop.route("/")def shop_index(): return render_template("index.html") # trùng tên — chỉ một file tồn tại
Giải pháp
Khai báo template_folder và static_folder khi tạo Blueprint, đặt template trong thư mục con trùng tên Blueprint:
# blueprints/admin/__init__.pyfrom flask import Blueprint, render_templateadmin = Blueprint( "admin", __name__, url_prefix="/admin", template_folder="templates", static_folder="static",)@admin.route("/")def index(): return render_template("admin/index.html")
Cấu trúc thư mục lúc này:
blueprints/ admin/ __init__.py templates/ admin/ index.html static/ admin.css
Trong template, trỏ tới file tĩnh của Blueprint bằng endpoint admin.static:
<link rel="stylesheet" href="{{ url_for('admin.static', filename='admin.css') }}">
Vài điểm cần nhớ:
- Thư mục template của Blueprint được thêm vào đường tìm kiếm với độ ưu tiên thấp hơn
templates/của app, nên app vẫn ghi đè được template của Blueprint khi cần. - Đặt template trong thư mục con trùng tên Blueprint (
admin/index.html) để tránh bị ghi đè vô tình: hai Blueprint cùng cóindex.htmlở gốc thư mục template thì Blueprint đăng ký trước thắng. static_folderchỉ truy cập được khi Blueprint cóurl_prefix— mặc định file nằm ở/admin/static/admin.css. Không có prefix, route/staticcủa app chiếm trước và file tĩnh của Blueprint không tới được.url_for("admin.static", filename="admin.css")sinh URL đúng kể cả khi đổiurl_prefixsau này, nên đừng hardcode/admin/static/...trong template.- Khi Flask load nhầm template, bật
app.config["EXPLAIN_TEMPLATE_LOADING"] = Trueđể Flask in ra từng bước nó tìm file ở đâu.
Áp dụng vào dự án của bạn
Kết hợp với Application Factory, mỗi Blueprint thành một thư mục tự chứa route, template và file tĩnh — copy cả thư mục sang dự án khác là chạy. Giữ ở templates/ gốc những gì dùng chung toàn app như base.html, macro, trang lỗi; chỉ tách phần riêng của từng module. Module nhỏ chỉ có một, hai template thì tách riêng là thừa — hãy tách khi tên file bắt đầu phải “gánh” thêm tiền tố tên module để khỏi trùng.
Bài viết liên quan
- Flask: tổ chức route gọn gàng bằng Blueprint khi dự án lớn dần
- Flask: dùng Application Factory (create_app) để app dễ test, dễ mở rộng ngay từ đầu
- Flask: tái sử dụng layout bằng template inheritance — extends và block trong Jinja2
Câu hỏi thường gặp
Không khai báo template_folder, Blueprint tìm template ở đâu?
Chỉ trong thư mục templates/ của app. Khai báo template_folder mới thêm thư mục riêng của Blueprint vào đường tìm kiếm, và thư mục của app vẫn được ưu tiên hơn.
Hai Blueprint cùng có index.html thì Flask lấy file nào?
Template của app thắng trước; giữa các Blueprint thì Blueprint đăng ký trước thắng. Cách an toàn nhất: đặt template trong thư mục con trùng tên Blueprint, ví dụ admin/index.html.
Vì sao url_for('admin.static', ...) trả về 404 dù file đã có?
Thường vì Blueprint không có url_prefix nên route /static của app chiếm trước. Thêm url_prefix="/admin" (hoặc static_url_path) rồi kiểm tra lại /admin/static/<tên file>.
Có nên chuyển hết template sang Blueprint?
Không. Template dùng chung như base.html, macro hay trang lỗi nên ở lại thư mục gốc để mọi Blueprint cùng kế thừa; chỉ tách template riêng của từng module.
Làm sao biết Flask đang load template từ file nào?
Bật app.config["EXPLAIN_TEMPLATE_LOADING"] = True: Flask in ra từng bước tìm kiếm mỗi lần render_template chạy, rất hữu ích khi template bị ghi đè mà không rõ vì sao.
💬 Bạn đã thử cách này trong dự án của mình chưa? Nếu gặp lỗi hoặc có cách làm gọn hơn, để lại bình luận bên dưới — mình đọc hết và sẽ bổ sung những ý hay vào bài.
Nguồn tham khảo
- Flask Documentation — Modular Applications with Blueprints
