humanize 是独立 python 库，需 pip install 并在每个 django 模板顶部 {% load humanize %} 才能使用 |intcomma、|intword 等过滤器；不支持 installed_apps 注册，且仅模板层生效。
Humanize 不是 Django 插件，而是独立的 Python 库，需单独安装并手动集成到 Django 模板中才能生效。 它不依赖 Django admin 或任何内置机制，也不能通过 INSTALLED_APPS 注册启用。直接在模板里用会报 Invalid filter 错误——这是最常见的卡点。
humanize 在 Django 中必须显式加载 filter
Django 默认不识别 humanize 提供的过滤器（如 |intcomma、|naturaltime），哪怕你已运行 pip install humanize。必须在模板顶部手动加载：
{% load humanize %}
否则所有 |intword、|naturalsize 等都会静默失效，页面显示原始数字或抛出 TemplateSyntaxError。
- 只对当前模板生效，每个要用的 .html 文件都得加这一行
- 不能写在 base.html 的
{% block content %}外部再继承——子模板仍需自己{% load humanize %} - 加载位置必须在任何使用过滤器的语句之前，顺序错也会报错
模板中使用 intcomma 和 intword 的典型场景
intcomma 适合金额、ID、统计数等需要千分位分隔但不缩写的场合；intword 更适合仪表盘、概览页里空间有限的大数值（如用户总数、访问量）。
-
{{ 1500000|intcomma }}→1,500,000 -
{{ 1500000|intword }}→1.5 million（注意：默认不带单位缩写如 “M”，要 “1.5M” 得自己写逻辑或换库） -
{{ 999|intword }}→999（小于 1000 不缩写，符合预期） - 对负数、小数也支持：
{{ -2500000.75|intcomma }}→-2,500,000.75
naturalsize 和 naturaltime 在 admin 或列表页中的实际限制
naturalsize 默认以 1024 为进制（KiB/MiB），而前端常需 1000 进制（KB/MB）；naturaltime 依赖传入的是 datetime 对象，不是字符串或时间戳——这两点极易踩坑。
-
{{ file.size|naturalsize }}输出1.2 MiB，若想显示1.2 MB，得加参数：{{ file.size|naturalsize:True }}（True表示 use_binary_prefix=False） -
{{ log.created_at|naturaltime }}要求log.created_at是datetime实例；如果是字符串"2026-06-12T14:30:00Z"，Django 模板无法自动解析，会原样输出或报错 -
naturaltime不处理时区：传入 naive datetime 时，结果可能与用户感知不符，建议统一转为 aware datetime 后再传入
真正容易被忽略的是：humanize 的所有过滤器都只作用于模板渲染阶段，无法在视图或模型层直接调用格式化结果用于 API 返回；如果前后端分离，这部分逻辑得移到 JS 或后端序列化时手动调用 humanize.naturalsize() 等函数处理。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
