Django-Unfold项目中语言切换器在prefix_default_language=False时的解决方案

在Django-Unfold项目中，当使用多语言支持时，开发者可能会遇到一个常见问题：当设置prefix_default_language=False时，语言切换器无法正常工作。这种情况表现为用户可以从默认语言切换到其他语言，但无法通过切换器返回到默认语言。

问题背景

Django的国际化(i18n)系统允许开发者通过URL前缀来区分不同语言版本的内容。默认情况下，Django会为所有语言（包括默认语言）添加前缀。例如：

/en/admin/ - 英语（默认语言）
/de/admin/ - 德语

当设置prefix_default_language=False时，默认语言将不带前缀：

/admin/ - 英语（默认语言）
/de/admin/ - 德语

问题分析

在Django-Unfold项目中，当采用上述配置时，语言切换器会出现以下行为：

1. 从默认语言（无前缀）切换到其他语言（带前缀）工作正常
2. 从带前缀的语言版本切换回默认语言时失败

这是因为Django-Unfold的语言切换器默认会尝试为所有语言添加前缀，包括默认语言。当默认语言不应该有前缀时，这种机制就会失效。

解决方案

要解决这个问题，开发者需要自定义语言切换选项。具体步骤如下：

1. 在项目的settings.py中定义语言选项：

UNFOLD = {
    "LANGUAGE_SWITCHER": {
        "en": "English",
        "de": "Deutsch",
    }
}

2. 确保URL配置正确：

urlpatterns = (
    [
        path("i18n/", include("django.conf.urls.i18n")),
    ]
    + i18n_patterns(
        path("admin/", admin.site.urls),
        prefix_default_language=False,
    )
)

3. 如果需要更复杂的控制，可以创建一个自定义的语言切换器函数：

def get_language_switcher(request):
    return [
        {"code": "en", "name": "English", "active": request.LANGUAGE_CODE == "en"},
        {"code": "de", "name": "Deutsch", "active": request.LANGUAGE_CODE == "de"},
    ]

UNFOLD = {
    "LANGUAGE_SWITCHER": get_language_switcher,
}

实现原理

通过自定义语言切换器，开发者可以完全控制语言切换的行为：

1. 对于默认语言（英语），切换器会生成不带前缀的URL
2. 对于其他语言（如德语），切换器会生成带前缀的URL
3. 当前活动语言会被正确标记

这种解决方案既保持了Django的国际化功能，又解决了默认语言无前缀时的切换问题。

最佳实践

1. 始终在开发环境中测试语言切换功能
2. 考虑使用Django的django.middleware.locale.LocaleMiddleware来处理语言检测
3. 对于复杂的多语言项目，建议使用Django的翻译系统配合URL前缀
4. 确保所有管理员界面中的静态文本都已正确标记为可翻译

通过以上方法，开发者可以在Django-Unfold项目中实现完美的多语言支持，无论是否使用默认语言前缀。