ImmortalWrt多语言支持配置：打造国际化路由器系统-优快云博客

ImmortalWrt多语言支持配置：打造国际化路由器系统

【免费下载链接】immortalwrt An opensource OpenWrt variant for mainland China users. 项目地址: https://gitcode.com/GitHub_Trending/im/immortalwrt

你是否曾因路由器界面语言单一而困扰？ ImmortalWrt（一个面向特定用户群体的开源 OpenWrt 变体）提供了完善的多语言支持解决方案。通过本文，你将学会如何配置系统语言环境、安装语言包以及定制本地化设置，让你的路由器界面真正实现"多国语言，一键切换"。

多语言支持框架解析

ImmortalWrt 的多语言支持基于 NLS（Native Language Support，本地语言支持）框架实现，核心配置集中在 include/nls.mk 文件中。该框架通过条件编译控制国际化组件的构建，主要包含两大模块：

字符编码转换：通过 libiconv-full 实现不同字符集间的转换
国际化支持：通过 libintl-full 提供 gettext 消息翻译功能

# [include/nls.mk](https://link.gitcode.com/i/ed1bd072fe52b48899dc4bafb50d54c1) 核心配置片段
ifeq ($(CONFIG_BUILD_NLS),y)
    ICONV_PREFIX:=$(STAGING_DIR)/usr/lib/libiconv-full
    INTL_PREFIX:=$(STAGING_DIR)/usr/lib/libintl-full
    # 启用完整的国际化编译选项
else
    # 禁用国际化支持
endif

编译配置开启多语言支持

在开始配置前，需要通过菜单配置启用基础的多语言支持组件。这一步将决定系统编译时是否包含国际化相关的库和工具链。

启用 NLS 支持

运行 make menuconfig 打开配置菜单
进入 Global build settings -> Enable NLS support
勾选 [*] Enable NLS support 选项
保存配置并退出

该配置对应 Config.in 中的 CONFIG_BUILD_NLS 选项，启用后将自动包含 include/nls.mk 中定义的编译参数。

选择目标语言包

LuCI（OpenWrt 的 Web 管理界面）的语言支持通过独立的 i18n 包实现。在配置菜单中可以找到大量以 luci-i18n- 为前缀的语言包，例如：

luci-i18n-base-zh-cn：中文（简体）基础语言包
luci-i18n-base-en：英文基础语言包
luci-i18n-firewall-zh-cn：防火墙模块中文语言包

这些语言包的配置定义分散在各个模块的 .in 文件中，通过 CONFIG_PACKAGE_luci-i18n-* 系列选项控制。

语言包安装与管理

对于已编译好的系统，可以通过 OPKG 包管理器在线安装语言包，无需重新编译整个固件。

常用安装命令

# 安装中文语言包
opkg update
opkg install luci-i18n-base-zh-cn luci-i18n-firewall-zh-cn

# 安装英文语言包
opkg install luci-i18n-base-en luci-i18n-firewall-en

语言包文件结构

安装后的语言包位于 /usr/lib/lua/luci/i18n/ 目录，每个语言包包含一个 .lmo（Luci Message Object）二进制文件，例如：

/usr/lib/lua/luci/i18n/base.zh-cn.lmo
/usr/lib/lua/luci/i18n/firewall.zh-cn.lmo

这些文件由 po2lmo 工具从 PO 翻译文件编译而来，ImmortalWrt 源码中维护了各语言的翻译文件。

Web 界面语言切换

完成语言包安装后，即可在 LuCI 界面中切换显示语言：

登录路由器管理界面
进入 系统 -> 系统 -> 语言和界面
在 语言 下拉菜单中选择所需语言
点击 保存 & 应用 完成设置

设置将立即生效，界面文字会切换为所选语言。如果某些模块显示为英文，通常是因为对应的语言包未安装。

高级定制：添加新语言翻译

如果需要支持官方未提供的语言，可以通过以下步骤添加自定义翻译：

获取 PO 模板文件：从 package/feeds/luci/luci/modules 找到对应模块的 .po 文件
使用 Poedit 等工具翻译文本
编译为 LMO 文件：po2lmo input.po output.lmo
上传至 /usr/lib/lua/luci/i18n/ 目录

ImmortalWrt 社区欢迎用户贡献翻译，具体流程可参考 package/emortal/autosamba/files/README.md 中的贡献指南。

故障排除与常见问题

语言包安装后不生效

检查是否安装了对应模块的语言包
清除浏览器缓存或使用隐私模式访问
重启 uhttpd 服务：/etc/init.d/uhttpd restart

部分菜单仍显示英文

这通常是因为该模块的语言包未安装。可以通过 opkg list | grep luci-i18n- 命令查找并安装对应模块的语言包。

编译时缺少语言支持

确保已启用 CONFIG_BUILD_NLS 和对应语言的 luci-i18n-* 选项，可通过 make defconfig 检查配置是否生效。

总结与扩展阅读

通过本文介绍的方法，你可以轻松实现 ImmortalWrt 系统的多语言支持。无论是中文、英文还是其他语言，都能通过灵活的配置和包管理机制实现无缝切换。