CVAT 多语言支持实战指南4 个问题看懂 CVAT 国际化配置【免费下载链接】cvatComputer Vision Annotation Tool (CVAT) is a leading platform for building high-quality visual datasets for vision AI. It offers open-source, cloud, and enterprise products, as well as labeling services, for image, video, and 3D annotation with AI-assisted labeling, quality assurance, team collaboration, analytics, and developer APIs.项目地址: https://gitcode.com/GitHub_Trending/cvat/cvatCVATComputer Vision Annotation Tool是构建计算机视觉 AI 数据集的开源标注平台。国际化i18n让软件显示不同语言文本的能力配置是团队多语言环境部署时最常卡住的环节。本文从你实际会遇到的问题出发讲清楚 CVAT 国际化里真实存在的支持点、怎么配置、怎么验证。 先说结论CVAT 的国际化落在三个位置先说结论CVAT 的多语言能力不是一个开关而是分散在三处——Django 后端、官方文档站、Web 标注界面。前两处有现成机制第三处界面基本还是纯英文。各层现状速查层位置已支持什么你要改什么后端 APIcvat/settings/base.py默认语言、时区LANGUAGE_CODE、环境变量TZ文档站site/i18n/en.toml文档少量文案新增对应语言的.toml标注 UIcvat-ui/无目前只能提社区贡献后端默认语言在哪里改配置文件里的关键两行# cvat/settings/base.py LANGUAGE_CODE en-us # 默认语言按需改成目标语言代码 USE_I18N True # Django 国际化总开关改完这两行后端就有了国际化基础。另外时区也走环境变量base.py里读取TZ缺省是Etc/UTC。翻译文件放哪里Django 的翻译机制是先用python manage.py makemessages -l zh_Hans把代码里的待翻译串提取成.po文件人工翻译后再compilemessages编译成可执行的.mo文件。注意当前仓库里还没有任何.po文件。也就是说后端翻译串尚未沉淀你提取出来的清单就是待翻译清单。API 消息真的会被翻译吗目前只有少数后端文件用了gettext标记翻译串例如 cvat/apps/iam/serializers.py、cvat/apps/engine/models.py。所以别指望所有 API 报错信息都会自动翻译没标记过的字符串仍会原样返回。文档站怎么增加一种语言文档站用 Hugo 静态站点生成器搭建语言包放在 site/i18n/ 目录。目前只有 site/i18n/en.toml 一个英文文件内容只有两个键# 参考 site/i18n/en.toml 的键仿写 site/i18n/zh.toml [footer_cvat_ai_privacy_notice] other 隐私政策 [footer_cvat_ai_terms_of_use] other 服务条款新增步骤就三步新建site/i18n/下的对应语言文件、照抄键名、填入译文。这一步最容易踩坑toml 里只覆盖页脚这类零散文案。文档正文在 site/content/en/ 下按英文目录组织想让正文也出中文版需要按 Hugo 的多语言内容目录规范另行搭建不只是加一个 toml 文件。Web 界面有语言切换吗直接回答默认没有。在 cvat-ui/ 里检索不到语言包文件和 i18n 库如 react-intl的引入界面文案是组件内的英文硬编码。这也是最常见的误区来源。如果你的团队确实需要多语言界面现实路径有两条给社区提翻译相关的贡献或等上游支持后再接入。别在对外承诺里写界面可切换语言。多语言部署的完整链路怎么走如果只想快速上手做到第 2 步改配置即可第 3 步用于上线前验收。准备确定目标语言的 RFC 5646 语言代码如zh-Hans、ja写进部署清单。配置修改 cvat/settings/base.py 的LANGUAGE_CODE在 docker-compose.yml 的服务环境变量里加TZ控制时区。验证改完重启后端用一条 API 请求和文档站页面各抽查一次确认语言与日期表现符合预期。# docker-compose.yml 服务段示例 environment: - TZAsia/Shanghai # 与 base.py 中 os.getenv(TZ) 对应⚠️ 三个常见误区误区一产品自带语言切换入口。后端有开关、界面没有别混淆这两层。误区二改了设置消息就自动翻译。没提取、没编译的字符串不会变makemessages和compilemessages两步缺一不可。误区三文档站多语言等于产品多语言。文档站只是 Hugo 站点的一小部分文案覆盖范围远小于后端和界面。✅ 要点回顾CVAT 国际化分三层后端、文档站、UI只有后端机制是现成可用的。后端默认语言由 cvat/settings/base.py 中LANGUAGE_CODE和USE_I18N两行决定。文档站加语言 在 site/i18n/ 新增一份.toml正文翻译另算。界面文案默认英文没有内置切换对外承诺要留余地。时区用环境变量TZ控制缺省Etc/UTC。操作提示修改LANGUAGE_CODE后务必先执行compilemessages再重启服务验证。没有编译过的翻译文件不会生效排查时请先确认这一步。【免费下载链接】cvatComputer Vision Annotation Tool (CVAT) is a leading platform for building high-quality visual datasets for vision AI. It offers open-source, cloud, and enterprise products, as well as labeling services, for image, video, and 3D annotation with AI-assisted labeling, quality assurance, team collaboration, analytics, and developer APIs.项目地址: https://gitcode.com/GitHub_Trending/cvat/cvat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
