Frappe LMS 多语言配置指南：让你的学习平台听懂用户的语言

Frappe LMS 多语言配置指南：让你的学习平台听懂用户的语言

【免费下载链接】lmsEasy to Use, 100% Open Source Learning Management System项目地址: https://gitcode.com/GitHub_Trending/lms1/lms

Frappe LMS 是一个 100% 开源的学习管理系统，内置多语言机制，可覆盖中文、西班牙语、阿拉伯语等 40 种语言。配置好之后，你的学员不必再对着英文界面猜功能。

🎯 先看三个场景：不解决会怎样

• 培训对象在西语区，"提交作业"只有英文版，学员完成率和提交质量都会下降。
• 新用户未登录时看到的是系统默认语言，登录后又变了，用户会以为站点出故障。
• 管理员用中文建课程后保留默认课名，系统按占位标题做清理时，语言没覆盖到就会漏处理。

这三件事的根源相同：平台没有把多语言链路接通。

⚙️ 看懂翻译如何运行：一个接口 + 一批文件 + 一个函数

数据流向是单向的，记住三个环节即可：

1. 翻译数据：lms/locale/下每种语言一个 .po 文件，共 40 个（如zh.po、es.po、fr.po），模板源文件是lms/locale/main.pot。
2. 后端接口：lms/lms/api.py的get_translations()按请求取语言——登录用户取User表的language字段，游客取System Settings的默认语言。
3. 前端入口：frontend/src/translation.js在 Vue 上注册全局__()。首次加载时拉取接口数据存入window.translatedMessages，之后组件调__('文本')得到当前语言；查不到就回退英文原文。

📁 动手配置：三步完成多语言接入

Step 1 准备翻译文件。打开lms/locale/，找到目标语言文件，补上空的msgstr，格式是成对的英文原文与译文：

msgid "Please evaluate and grade it." msgstr "请进行评估并评分。" msgid "Row {0}" msgstr "第 {0} 行"

预期结果：文件中出现完整对照条目，占位符{0}保留原样。

Step 2 校验语言来源。登录后检查当前User记录的language字段；游客没有个人资料，要改System Settings的默认语言：

@frappe.whitelist(allow_guest=True) def get_translations(): if frappe.session.user != "Guest": language = frappe.db.get_value("User", frappe.session.user, "language") else: language = frappe.db.get_single_value("System Settings", "language") return get_all_translations(language)

预期结果：切换用户语言后，接口返回的翻译随之变化。

Step 3 验证界面效果。刷新页面看按钮文案，或在控制台执行__('Row {0}', [7])。预期结果：界面显示目标语言，占位数字位置正确。

📖 从界面延伸到课程内容：管理内容层本地化

界面翻译只覆盖按钮、提示等固定文案，课程内容不会自动翻译。课程名、描述、课时正文是独立的记录，需要你按语言管理：

• 每个目标语言建一条独立的LMS Course，把描述与课时标题译好后填入，不要把多种语言塞进同一条记录。
• 视频可用同一素材挂不同语言的版本或字幕，播放块指向对应地址即可。
• 后端已有按语言处理的范例可参考：course_lesson.py的_untitled_placeholders()会把每种语言下的"Untitled lesson"占位标题都纳入查找。

🐛 排查三个典型问题与取舍

1. 新代码文案没翻译。.po 由源码提取生成，新增文案后若不同步模板，.po 里就没有对应条目，__()直接回退英文。解法：先走项目的 Crowdin 同步流程（crowdin.yml），再补漏项。
2. 占位符错位。前端同时支持__('Row {0}').format(7)与__('Row {0}', [7])两种写法，但译文里把{0}和{1}位置调换，展示的数字就对调了。解法：翻译时只改文字，占位编号一律不动。
3. 登录前后语言不一致。游客取系统默认、用户取个人设置，登录后页面语言跳变属于预期行为。解法：在帮助文档写清"默认语言只影响未登录访客"，避免用户误报。

🚪 下一步：现在就能做

挑一个你最需要的目标语言，打开lms/locale/下对应的 .po 文件，把空的msgstr补齐，再把测试站点的用户语言切换过去验证一遍。

【免费下载链接】lmsEasy to Use, 100% Open Source Learning Management System项目地址: https://gitcode.com/GitHub_Trending/lms1/lms