Django i18n无法捕获JS渲染函数中字符串的问题排查

核心问题拆解 #

• 内嵌在HTML模板<script>标签里的gettext()调用（"Launch this app"、"App under review"）无法被makemessages命令提取到django.po或djangojs.po文件中
• 偶尔无规律出现被注释（#~前缀）的翻译条目，无文件路径/行号关联
• 翻译偶尔在无对应po映射时生效，疑似缓存导致

原因排查与解决方案 #

1. JS字符串无法被提取的根本原因 #

Django的makemessages -d djangojs默认只会扫描独立的.js文件，不会解析HTML模板里的<script>标签内容，这是工具的默认行为限制，并非Bug：

• 若要提取HTML内嵌JS的翻译字符串，要么把JS代码移到独立的.js文件中，要么手动指定扫描.html模板文件
• 临时执行命令：makemessages -d djangojs --all --extension html，强制让工具扫描HTML文件中的JS代码

2. 注释态翻译条目（#~）的出现原因 #

这种条目是po文件的过时标记，说明这些msgid曾经被提取过，后来因为工具扫描不到对应字符串，被标记为废弃。无规律出现的可能原因：

• 之前某次扫描时偶然捕获到了这些字符串（比如临时把JS移到独立文件、或者命令参数正确过），之后扫描又没捕获到，就变成了注释态条目
• 版本控制工具（如Git）切换分支时，po文件的旧内容被残留或合并进来

3. 无映射却翻译生效的缓存问题 #

出现这种情况大概率是多层缓存叠加导致：

• 浏览器缓存：浏览器缓存了旧的翻译JS文件（Django生成的django.js翻译文件），普通刷新可能没加载最新版本
• Django服务器缓存：开发环境下的runserver可能缓存了翻译文件，需要重启服务器
• 翻译文件编译缓存：若没执行compilemessages，或者编译后的.mo文件没更新，可能残留旧的翻译内容

总结与实操步骤 #

1. 优先把内嵌JS代码迁移到独立的.js文件中，确保makemessages -d djangojs能正常扫描
2. 若必须保留内嵌JS，执行命令：makemessages -d djangojs --all --extension html --extension js覆盖扫描范围
3. 清理注释态条目：直接删除#~开头的行，避免混淆
4. 彻底清除缓存：
   • 强制刷新浏览器（Ctrl+Shift+R）
   • 重启Django开发服务器
   • 重新执行compilemessages编译最新的翻译文件

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