OnlyOffice语言设置需按部署形态分别处理:桌面版通过设置界面选择简体中文并重启;Document Server需修改default.js中defaultLanguage为"zh-CN"并重启服务;Web集成应在editorConfig中添加lang:"zh-CN";深度汉化可手动替换zh-CN.json语言包并重建缓存。

如果您在使用 OnlyOffice 时发现界面或新建文档默认显示为英文或其他语言,而非简体中文,则可能是由于语言配置未正确设定。以下是针对不同部署形态(桌面版、在线 Document Server、Web 集成)修改 OnlyOffice 语言的具体操作步骤:
一、桌面编辑器中切换界面语言
该方法适用于已安装 OnlyOffice Desktop Editors 的 Windows/macOS/Linux 用户,通过图形化设置直接更改 UI 显示语言,无需修改配置文件。
1、启动 OnlyOffice 桌面编辑器,点击右下角设置(Settings)图标(齿轮状按钮)。
2、在弹出窗口中找到“界面语言”下拉菜单,点击展开选项列表。
3、从列表中选择“简体中文”(注意:部分旧版本可能显示为“Chinese (Simplified)”)。
4、点击窗口底部的“应用”按钮,系统将提示重启编辑器以使更改生效。
5、关闭并重新打开 OnlyOffice 桌面编辑器,确认顶部菜单、对话框及状态栏均已显示为中文。
二、Document Server 修改全局默认语言
该方法适用于自建 OnlyOffice Document Server 的管理员,通过修改服务端配置文件,使所有新创建文档及 Web 界面默认采用简体中文,影响所有用户访问行为。
1、以 root 权限登录服务器,定位到配置目录:/var/www/onlyoffice/documentserver/config/。
2、打开文件default.js(或 production.json,取决于版本),查找包含 "defaultLanguage" 或 "lang" 的配置项。
3、将对应字段值修改为:"zh-CN"(注意大小写与连字符格式,不可写作 zh_cn 或 chinese)。
4、若配置结构嵌套较深(如位于 services.Converter.defaultLanguage 节点下),请确保路径完整且 JSON 格式合法。
5、保存文件后,执行命令重启服务:supervisorctl restart all 或 systemctl restart onlyoffice-documentserver。
6、清除浏览器缓存并刷新 OnlyOffice Web 页面,验证新建文档的菜单、工具栏及右键上下文是否已汉化。
构建并调试跨Office自动化流程,实现Word、Excel、PowerPoint之间的内容迁移,使用Open XML、VBA、python-docx、openpyxl、py...
三、Web 集成时通过 editorConfig 指定语言
该方法适用于开发者将 OnlyOffice 集成至自有系统(如 CMS、OA、协作平台),通过前端初始化参数动态控制单次会话的语言,优先级高于服务端全局设置。
1、在调用 ONLYOFFICE.Editor() 构造函数时,在 editorConfig 对象中添加 lang 字段。
2、设置其值为:"zh-CN",例如:lang: "zh-CN"。
3、确保该参数位于 editorConfig 根层级,而非嵌套于 customization 或 user 下。
4、若同时设置了 customization.goback.url 或其他本地化相关字段,需确认无冲突覆盖。
5、重新加载集成页面,在文档加载完成后检查地址栏 URL 是否携带 lang=zh-CN 查询参数(部分版本会自动追加)。
四、手动替换语言包实现深度汉化
该方法适用于官方未完全覆盖的界面元素或定制化部署场景,通过直接注入翻译 JSON 文件,绕过配置限制实现全量语言适配。
1、访问 GitHub 官方仓库,下载简体中文语言包:https://github.com/ONLYOFFICE/web-apps/tree/master/apps/documenteditor/main/locale/zh-CN.json。
2、将下载的 zh-CN.json 文件复制至服务器对应路径:/opt/onlyoffice/documentserver/web-apps/apps/documenteditor/main/locale/。
3、同步更新移动端语言包路径:/opt/onlyoffice/documentserver/web-apps/apps/documenteditor/mobile/locale/。
4、检查文件权限,确保运行用户(如 www-data 或 onlyoffice)对该 JSON 文件具有读取权限。
5、执行命令重建前端资源缓存:documentserver-generate-allfonts.sh 并重启服务。
6、使用无痕模式访问 OnlyOffice Web 端,确认所有按钮、提示语、错误消息均呈现为中文文本。










