Apache Superset 6.0.0界面翻译不全问题求助

1. 验证前端翻译资源的正确性与打包状态 #

• 检查./superset-frontend/public/translations/ru目录下的messages.json，确保所有待翻译的键值对都已正确填充，无语法错误（如逗号遗漏、引号不匹配）。
• 重新执行前端翻译构建命令，确认过程无报错：

  npm run build-translation
  npm run build
  

• 核对docker-compose配置中的卷挂载规则，确保superset-frontend/dist或public/translations目录被正确映射到容器内对应路径，避免构建后的静态资源未被容器加载。

2. 检查后端翻译文件的编译与生效 #

• 打开./superset/translations/ru/LC_MESSAGES/messages.po，确认所有目标字符串的msgstr字段已填写正确翻译，且未被标记为fuzzy（模糊翻译会被系统忽略）。
• 重新编译.po为后端依赖的.mo二进制文件：

  pybabel compile -d ./superset/translations/
  

• 进入容器验证翻译文件状态：

  docker exec -it <superset-container-id> ls -l /app/superset/translations/ru/LC_MESSAGES/
  

  确保messages.mo存在且文件大小非空。

3. 清理缓存与强制刷新 #

• 浏览器端使用Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（Mac）强制刷新，清除旧的前端缓存资源。
• 进入容器清理Superset内部缓存：

  docker exec -it <superset-container-id> flask cache clear
  

• 重启容器时彻底清理匿名卷，避免缓存残留：

  docker compose -f docker-compose-image-tag.yml down -v
  docker compose -f docker-compose-image-tag.yml up --force-recreate
  

4. 验证语言配置与激活状态 #

• 检查superset_config.py是否正确启用俄语支持：

  LANGUAGES = {
      'en': {'flag': 'us', 'name': 'English'},
      'ru': {'flag': 'ru', 'name': 'Русский'},
  }
  # 可选：设置默认语言为俄语
  # BABEL_DEFAULT_LOCALE = 'ru'
  

• 在Superset界面右上角的语言切换菜单中，确认已选中Русский选项。

5. 排查未翻译字符串的来源 #

• 若未翻译内容来自第三方组件或插件，这类文本可能不在默认翻译文件中，需重新提取所有可翻译字符串：
  • 后端重新提取并更新翻译模板：

    pybabel extract -F babel.cfg -o ./superset/translations/messages.pot ./superset
    pybabel update -i ./superset/translations/messages.pot -d ./superset/translations/
    

  • 前端重新提取翻译键：

    npm run extract-translation
    

  之后补全messages.po和messages.json中的翻译内容，再重新执行编译与构建命令。

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