You need to enable JavaScript to run this app. Django模板中如何移除字符串特定分隔符后的所有内容
优惠活动
大模型
产品
解决方案
定价
更多

Django模板中如何移除字符串特定分隔符后的所有内容

实现Django模板中字符串拆分取首项的方法

Django模板语法本身不支持直接对变量做索引取值(如[0]),也不支持在过滤器调用后直接拼接索引操作,因此需要通过自定义模板过滤器实现需求,配合Django内置工具可以快速达成目标。

步骤1:搭建自定义过滤器的目录结构

首先确保你的业务App已经在settings.py的INSTALLED_APPS中完成注册,随后在App根目录(与models.py、views.py同级)下创建如下结构:

  • 创建templatetags文件夹(必须为这个固定名称)
  • 文件夹内创建空的__init__.py,标记其为Python包
  • 再创建自定义过滤器逻辑文件,例如命名为string_helpers.py

步骤2:编写自定义过滤器逻辑

在string_helpers.py中写入以下代码:

from django import template

# 注册过滤器实例
register = template.Library()

# 方案1:通用split过滤器,可配合内置工具取任意位置的元素
@register.filter(name='split')
def split_string(value, delimiter):
    # 处理非字符串的异常情况,避免报错
    if not isinstance(value, str):
        return []
    return value.split(delimiter)

# 方案2:直接封装拆分取首项的过滤器,调用更简洁
@register.filter(name='split_first')
def split_first(value, delimiter):
    if not isinstance(value, str):
        return ''
    parts = value.split(delimiter)
    # 拆分后为空时返回空字符串,避免索引报错
    return parts[0] if parts else ''

步骤3:模板中调用方式

前置操作

所有自定义过滤器使用前,必须在模板顶部加载对应标签文件:

{% load string_helpers %}

对应两种方案的调用写法

  • 方案1(通用拆分+内置first取首项):
    利用Django内置的first过滤器直接取可迭代对象的第一个元素,写法为:
    {{ product.title|split:' - '|first }}
    
  • 方案2(封装后的简化写法):
    不需要额外调用内置过滤器,直接一步到位:
    {{ product.title|split_first:' - ' }}
    

注意:Django模板的过滤器参数使用冒号:分隔,不支持括号传参的Python原生写法,因此不能写成split(' - '),需按照模板语法调整为split:' - '。

注意事项

  • 修改templatetags下的代码后,需要重启Django开发服务器才能生效,因为过滤器是在服务启动阶段加载的。
  • 如果拆分后的字符串可能存在分隔符前后带空格的情况,可以在过滤器逻辑中对拆分后的项做strip()处理,避免取到空字符。

内容的提问来源于stack exchange,提问作者Thibaut

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 19:54:05