打破语言壁垒：AFFiNE全球化知识协作平台搭建指南

你还在为跨国团队协作时的语言障碍烦恼吗？AFFiNE国际化功能让你一键切换25种语言界面，轻松管理全球知识库。本文将带你3步实现无缝跨国协作，从环境配置到内容翻译全流程掌握。

AFFiNE国际化架构解析

AFFiNE采用业界领先的i18next框架实现全球化支持，通过模块化设计确保多语言系统的灵活性与可扩展性。核心架构包含三大组件：

• 翻译核心模块：基于i18next实现的语言切换引擎，支持动态加载语言包与实时更新
• 语言资源系统：预编译的多语言文件与自动生成的类型定义，确保翻译准确性
• 本地化工具链：提供完整的翻译工作流支持，包括进度追踪与质量检测

核心实现代码位于packages/frontend/i18n/，其中src/i18next.ts实现了初始化逻辑，通过getOrCreateI18n函数构建单例翻译实例，支持25种语言的无缝切换。

本地化环境快速配置

步骤1：安装依赖

yarn install

步骤2：配置语言包

AFFiNE默认支持25种语言，语言完整性数据存储在i18n-completenesses.json中，包含以下主要语言：

语言代码	语言名称	完成度
en	英语	100%
zh-Hans	简体中文	100%
ja	日语	100%
fr	法语	100%
de	德语	100%

步骤3：启动应用

yarn dev

启动后可在设置界面切换语言，路径为设置 > 外观 > 显示语言，对应代码实现位于src/react.ts中的useAFFiNEI18N钩子。

多语言内容管理实战

翻译文件结构

翻译文本通过代码生成器自动生成，主要文件包括：

• i18n.gen.ts：包含所有翻译键的类型定义
• utils/time.ts：时间格式化的本地化实现
• 语言资源通过动态导入加载，支持按需加载优化性能

团队协作流程

1. 翻译贡献：通过社区平台提交翻译，参考翻译指南
2. 版本控制：翻译文件与代码一同纳入版本管理
3. 质量检查：通过完整性检查工具确保翻译质量

界面示例

上图展示了中文界面的设置页面，包含语言切换选项与本地化的界面元素。

进阶功能与最佳实践

动态语言切换

无需刷新页面即可切换语言，实现代码：

import { I18n } from '@affine/i18n';

// 切换为简体中文
I18n.changeLanguage('zh-Hans');

RTL支持

自动适配从右到左语言（如阿拉伯语、希伯来语），通过CSS变量控制布局方向。

贡献翻译

1. Fork仓库并克隆到本地
2. 修改对应语言的翻译文件
3. 提交PR并参考贡献指南

结语与资源链接

AFFiNE的国际化架构为全球用户提供无缝的多语言体验，目前已支持25种语言，覆盖主要使用场景。通过完善的本地化工具链与社区协作流程，持续提升翻译质量与覆盖范围。

• 官方文档：docs/
• 国际化模块源码：packages/frontend/i18n/
• 测试用例：utils/tests/time.spec.ts
• 社区翻译平台：i18n General Space

通过本文指南，您已掌握AFFiNE国际化环境的搭建与内容管理方法，可根据实际需求扩展更多语言支持或优化现有翻译。