企业官网建设流程全解析

RunCat 365 多语言支持完整指南：4 步让任务栏小猫说出新语言

【免费下载链接】RunCat365A cute running cat animation on your windows taskbar.项目地址: https://gitcode.com/GitHub_Trending/ru/RunCat365

RunCat 365 把一只小猫放进了 Windows 任务栏：电脑负载越高，它跑得越快，瞄一眼就知道机器忙不忙。它内置 8 种语言的多语言支持，界面会自动跟随系统语言走。这篇文章讲清多语言是怎么实现的，再带你用 4 步亲手加一门新语言，最后附上几个避坑技巧。

为什么右键小猫后你只看到英文

想象一下这个场景：你刚装好 RunCat 365，右键点托盘里的小猫想看它能干什么。弹出来的菜单是清一色的英文——Runner、Settings、Information、Endless Game、Exit。小猫跑得快慢很直观，但你想换主题、设开机启动时，得先猜出哪个词是哪个。

好消息是，项目已经有人翻译好了简中、繁中、日语、韩语、法语、德语、西班牙语。你的系统如果就是中文，界面会自动跟着变，什么也不用做。要是还缺你想用的语言，也不用慌——这套多语言机制非常有规律，看懂之后自己就能加。

RunCat 365 多语言机制解析：resx 资源文件一览

它用的是 .NET 的资源文件（ResX，一种存放键值对的 XML 格式）机制。说人话就是：英文默认文本放在一个 XML 文件里，每种语言对应一个同名文件，靠相同的"键"一一对应。

启动时，程序读取 Windows 当前的显示语言（文化信息，Culture Info，决定程序显示哪种语言），映射到支持的 8 种语言之一，再设置为应用当前语言。之后代码里所有文案都不写死文字，而是统一按键名查资源文件，运行时自动取出对应语言的版本。关键文件都在 RunCat365/Properties/ 目录：

RunCat365/ ├── Program.cs # 启动时按系统语言设置当前 Culture ├── SupportedLanguage.cs # 语言枚举、文化信息、字体映射 └── Properties/ ├── Strings.resx # 英文默认文本（基准文件） ├── Strings.zh-CN.resx # 简体中文 ├── Strings.zh-TW.resx # 繁体中文 ├── Strings.ja.resx # 日语 ├── Strings.de.resx # 德语 ├── Strings.fr.resx # 法语 ├── Strings.ko.resx # 韩语 ├── Strings.es.resx # 西班牙语 └── Strings.Designer.cs # 自动生成的强类型访问类

代码里引用文案时只写Strings.Menu_Exit这样的属性，具体显示"退出"还是"Exit"，取决于当前语言。

4 步给 RunCat 365 添加一种新语言

步骤 1：获取项目源码

把仓库克隆到本地，所有改动都在本地进行：

git clone https://gitcode.com/GitHub_Trending/ru/RunCat365

✅ 预期结果：得到 RunCat365 文件夹，里面能看到 RunCat365.sln 解决方案文件。

步骤 2：复制默认资源文件作为翻译模板

以添加葡萄牙语为例，在RunCat365/Properties下复制基准文件并改名。文件名规则是"语言代码-地区代码"：

cp RunCat365/Properties/Strings.resx RunCat365/Properties/Strings.pt-BR.resx

✅ 预期结果：Properties 目录下多出一个 Strings.pt-BR.resx，内容和英文基准文件一致。

步骤 3：逐条填写译文

用文本编辑器打开新文件，只改<value>里的内容，name一个字母都不要动——它是查找翻译的键，改名就会找不到：

<data name="Menu_Exit" xml:space="preserve"> <value>Sair</value> </data> <data name="Menu_Settings" xml:space="preserve"> <value>Configurações</value> </data>

✅ 预期结果：文件里所有菜单和提示的<value>都变成了你的目标语言。

步骤 4：在代码中登记新语言

只加文件还不够，要在 SupportedLanguage.cs 里登记，共 3 处：枚举、文化信息映射、字体。

enum SupportedLanguage { Portuguese, // 1. 新语言登记到枚举 }; // 2. GetDefaultCultureInfo 中：映射到哪个文化信息 SupportedLanguage.Portuguese => new CultureInfo("pt-BR"), // 3. GetFontName 中：菜单渲染用的字体 SupportedLanguage.Portuguese => "Consolas",

然后构建验证一下：

dotnet build RunCat365.sln

✅ 预期结果：命令行输出 Build succeeded，没有编译错误。

切换 RunCat 365 界面语言的常见坑与验证方法

⚠️ 改动前看一眼这三个高频卡点，能省不少排查时间。

问题：界面一半英文一半新语言原因：name键和基准文件对不上，或有<value>漏翻，漏翻的部分会回退显示英文。 解决：对照英文文件逐条核对键名，保证一致；新增文案时记得同步补进所有语言文件，这是项目约定。

问题：新语言完全没生效，还是默认英文原因：只加了 resx 文件，忘了在 SupportedLanguage.cs 登记。 解决：补全枚举、文化信息、字体 3 处后再重新构建运行。

问题：新增文案键后，代码里访问不到原因：Strings.Designer.cs是自动生成的强类型访问类，不重新生成就没有新键。 解决：在 Visual Studio 中双击 resx 文件，让工具自动刷新访问类；别手改 Designer 文件。

验证是否生效，两种方式都可以：

// 方式一：小段测试代码快速验证资源读取 RunCat365.Properties.Strings.Culture = new CultureInfo("pt-BR"); Console.WriteLine(RunCat365.Properties.Strings.Menu_Exit); // 应输出 Sair

方式二是界面检查：运行应用，把系统显示语言设为目标语言，右键托盘图标看菜单是否全部本地化；再打开无尽游戏窗口，确认"按空格开始"之类的提示也换成了你的语言。

多语言配置完成后的进阶玩法

💡 以下内容不是必需的，给想更深入一点的你留几个口子。

• 用 ResXManager 同步翻译：8 个语言文件手工对齐容易漏，ResXManager 可以对比、导出 Excel，把翻译工作分出去。
• 翻译独立分支维护：把翻译放在单独的 locale 分支，和日常功能开发互不打扰，合并冲突少很多。
• 自定义跑步者：不是猫派也可以，自己准备帧动画导进任务栏，管理界面本身同样是本地化的，相关逻辑在 CustomRunnerRepository.cs。

到这里，你已经知道 RunCat 365 的多语言就是"每种语言一个 resx 文件 + 一处语言登记"。系统语言是中文时它能自动切中文，缺的语言你也可以自己补上。更多细节可以看 README.md 和 官方文档页。顺手给项目点个 Star 吧，毕竟这只小猫真的很努力在跑。

【免费下载链接】RunCat365A cute running cat animation on your windows taskbar.项目地址: https://gitcode.com/GitHub_Trending/ru/RunCat365