Django4.2中使用django-tagging遇ImportError：无法导入smart_text

问题描述 #

我正在项目中使用django-tagging包实现标签功能，当前Django版本为4.2.0，运行时出现以下错误：

File "C:\Users<user>\Desktop<App>\models.py", line 9, in 
from tagging.fields import TagField
File "C:\Users<User>\Desktop<User><App>\env\lib\site-packages\tagging\fields.py", line 9, in 
from tagging.forms import TagField as TagFormField
File "C:\Users<User>\Desktop<User><App>\env\lib\site-packages\tagging\forms.py", line 8, in 
from tagging.models import Tag
File "C:\Users<User>\Desktop<User><App>\env\lib\site-packages\tagging\models.py", line 8, in 
from django.utils.encoding import smart_text
ImportError: cannot import name 'smart_text' from 'django.utils.encoding' ("C:\Users<User>\Desktop<User><App>\env\lib\site-packages\django\utils\encoding.py)

我的models.py代码片段：

class ModelName(models.Model):
     .....
     tags = TagField()

原因 #

django-tagging是较老旧的包，未适配Django4.x版本。Django3.0+已弃用smart_text，并在Django4.x中彻底移除，替换为smart_str（或直接使用Python内置str），导致旧版django-tagging无法导入该方法。

解决办法 #

方法一：更换维护活跃的标签包（推荐） #

改用django-taggit，这是当前Django生态中维护最活跃的标签管理包，完全支持Django4.2及更高版本。

• 安装命令：

pip install django-taggit

• 修改models.py代码：

from taggit.managers import TaggableManager

class ModelName(models.Model):
    # ... 其他字段
    tags = TaggableManager()

• 在settings.py的INSTALLED_APPS中添加应用：

INSTALLED_APPS = [
    # ... 其他已安装应用
    'taggit',
]

方法二：修改django-tagging源码（不推荐） #

如果必须使用django-tagging，可手动修改包内代码临时修复：

1. 找到虚拟环境中tagging的models.py文件（路径参考错误提示中的C:\Users<User>\Desktop<User><App>\env\lib\site-packages\tagging\models.py）
2. 将第8行的from django.utils.encoding import smart_text替换为：

try:
    from django.utils.encoding import smart_text
except ImportError:
    from django.utils.encoding import smart_str as smart_text

也可直接替换为from django.utils.encoding import smart_str，并将代码中所有smart_text调用改为smart_str。

注意：此方法仅为临时修复，后续包更新或Django版本升级可能再次出现兼容问题。

内容的提问来源于stack exchange，提问作者karimi