ContextMenuManager 是一款免费的 Windows 右键上下文菜单管理程序（支持 Windows 7 – 11），内置简体中文、English 等多套语言包，并且允许用户自行添加所在地区的新语言。本文完整梳理了语言包的位置、结构和使用方法，带你快速切换或制作一份属于自己的界面语言。

已内置哪些语言包？

程序仓库的 languages/ 目录存放了所有官方语言包，每个文件对应一种语言：

💡 界面文字的默认模板还打包在程序内部，见 AppLanguageDic.ini，它是编写新语言包时最重要的参照。

一键切换界面语言（新手推荐）

最简单的用法是直接在程序里切换，无需任何手动操作：

1. 打开 ContextMenuManager，在左侧边栏点击齿轮图标进入设置，再选择Language（语言）页面；
2. 在语言下拉框中选择目标语言（下拉框会扫描语言目录里所有*.ini文件并显示其显示名称）；
3. 确认弹窗提示后，程序会自动重启并应用新语言。

语言页面还提供了三个实用按钮：

• Open（打开目录）：直接打开当前语言包存放的文件夹；
• Download（下载）：从在线语言仓库拉取最新语言包（见下文）；
• Translate（翻译工具）：内置的可视化翻译编辑器（见下文）。

相关实现可查看 LanguagesView.xaml.cs。

在线下载语言包

如果你希望把语言更新到最新版，或获取尚未随安装包附带的语言：

1. 在语言页面点击Download（下载）按钮；
2. 程序会请求语言仓库的接口，弹出语言选择框；
3. 选中语言后确认，.ini文件会被自动保存到本地语言目录，并立即生效于下拉列表。

语言包实际存放位置为程序配置目录下的Languages子文件夹，路径定义见 AppConfig.cs（即%AppData%\ContextMenuManager\Config\Languages，若程序以管理员方式安装则为程序目录\Config\Languages）。语言页面上方的小字也会实时显示该路径，方便你定位文件。

手动添加自定义语言包

如果你想使用自己或社区整理的语言包，只需三步：

1. 准备一个标准的xx-XX.ini文件（如fr-FR.ini表示法语）；
2. 确认文件[General]节中的Language一行已填写，例如Language = fr-FR 法语——程序依赖它来显示语言名称；
3. 将文件放入上文的Languages文件夹，回到语言页面点击刷新或直接重启程序，新语言即会出现在下拉框中。

从零创建一份新语言包

语言包就是普通的 INI 文本文件，结构非常简单。以 zh-CN.ini 为例，头部通常包含译者信息：

[General] AppName = Windows右键管理 Language = zh-CN 简体中文 Translator = 你的名字 TranslatorUrl = null

完整语言包共10 个分组，按界面区域划分：

编写规则（来自 en-US.ini 头部注释）：

• 📝 等号右侧填翻译文本，左侧键名不要改动；
• 📝 暂时不会翻译的项，值留空即可，程序会自动回退显示默认英文；
• 📝 需要换行时使用\r\n或\n转义；
• 📝 保存时请选择Unicode（UTF-16）编码，避免中文等文字乱码。

使用内置翻译工具（推荐贡献者）

程序内置了可视化的翻译编辑器，无需手动对 300 多行键值。进入语言页面点击Translate（翻译工具）：

1. 编辑器按「Section → Key」两级下拉列出全部文本键，左侧始终显示默认英文原文；
2. 可选地通过Browse（浏览）按钮载入一份已有语言包作为参考底稿（如从 zh-CN 出发翻译）；
3. 在New Translation（新译文）框中逐条填写翻译，修改会即时记录；
4. 点击保存，程序会弹出保存对话框，默认文件名取自[General]中的语言代码（如fr-FR.ini），保存到Languages目录后新语言立即可用。

翻译工具的完整实现见 LanguagesView.xaml.cs。

常见问题

Q1：切换语言后为什么没有立即生效？切换语言需要重启程序，程序会弹出确认框自动重启，点击"取消"则会撤销切换（见 LanguagesView.xaml.cs）。

Q2：新语言包放好后没有出现在下拉框？检查两点：文件名是否为标准的语言代码.ini格式；[General]节的Language是否已填写显示名称。程序启动时会扫描语言目录下所有*.ini文件。

Q3：程序默认使用哪种语言？若未指定语言，程序会读取系统区域设置（如zh-CN、en-US），若对应语言包存在则自动启用，否则回退到内置英文模板。

完成以上任意一种方式，你就能让 ContextMenuManager 说"你家乡的话"了。祝你翻译愉快！