OnlyOffice怎么设置中文_修改OnlyOffice语言教程

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

不少朋友在初次使用OnlyOffice时，可能会遇到一个小麻烦：界面或者新建的文档，默认显示的是英文或者其他语言，而不是我们习惯的简体中文。别担心，这通常只是语言配置没设对。其实，根据你使用OnlyOffice的方式不同——是装在电脑上的桌面软件，还是访问在线的文档服务器，又或者是集成在自己网站里的编辑器——调整语言的方法也略有区别。下面，咱们就分门别类，把每种情况下的设置步骤都捋清楚。

一、桌面编辑器中切换界面语言

如果你在Windows、macOS或者Linux电脑上安装了OnlyOffice Desktop Editors，那么恭喜你，这是最直观的一种方式。整个过程就像设置其他软件一样，在图形界面里点几下就能完成，完全不需要去碰那些复杂的配置文件。

1. 首先，打开你的OnlyOffice桌面编辑器。注意看右下角，那里有一个齿轮形状的设置（Settings）图标，点击它。

2. 设置窗口弹出后，在里面找到“界面语言”这个下拉菜单，点开它，会看到一个长长的语言列表。

3. 接下来，从列表里找到并选择“简体中文”。这里有个细节要注意：如果你用的是比较老的版本，选项可能显示为“Chinese (Simplified)”，选它也是一样的。

4. 选好之后，别忘了点击窗口底部的“应用”按钮。这时，软件通常会提示你需要重启才能让更改生效。

5. 所以，关掉编辑器再重新打开它。现在检查一下，顶部的菜单栏、各种对话框，还有状态栏，是不是都已经变成熟悉的中文了？

二、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”，写成“zh_cn”或者“chinese”是无效的。

4. 有时候，这个配置项可能嵌套得比较深，比如藏在services.Converter.defaultLanguage这样的路径下面。这时候，你需要确保修改的路径完整无误，并且整个JSON格式保持合法，别多删或少了个逗号。

5. 保存好配置文件，然后在终端里执行重启服务的命令。通常可以用supervisorctl restart all，或者systemctl restart onlyoffice-documentserver，具体取决于你的服务管理方式。

6. 最后一步，清空一下浏览器的缓存，然后刷新OnlyOffice的网页。打开一个新文档看看，菜单、工具栏，甚至右键菜单，是不是都已经成功汉化了？

三、Web 集成时通过 editorConfig 指定语言

如果你是开发者，把OnlyOffice编辑器集成到了自己的系统里，比如某个内容管理系统、OA平台或者协作工具里，那么语言控制就得从前端入手了。通过在初始化参数里动态指定，可以精确控制单次编辑会话的语言，这个设置的优先级甚至高于服务端的全局配置。

1. 在调用ONLYOFFICE.Editor()这个构造函数的时候，注意看传给它的配置对象editorConfig。你需要在这个对象里，添加一个lang字段。

2. 把这个字段的值同样设置为："zh-CN"。写出来大概是这样：lang: "zh-CN"。

3. 关键点来了：确保这个lang参数是放在editorConfig的根层级下的，不要把它嵌套到customization或者user这些子对象里面去，否则可能不生效。

4. 如果你的配置里还同时设置了customization.goback.url或者其他与本地化相关的字段，最好检查一下，确保它们之间没有冲突或相互覆盖。

5. 配置完成后，重新加载你的集成页面。等文档加载完毕，可以留意一下浏览器地址栏的URL，有些版本的OnlyOffice会自动在后面追加lang=zh-CN这样的查询参数，这也是一个判断是否生效的小技巧。

四、手动替换语言包实现深度汉化

前面几种方法已经能解决大部分问题，但如果你遇到官方翻译没有完全覆盖的界面元素，或者有非常定制化的部署需求，那么可以考虑这个“终极方案”：手动替换语言包文件。这种方法能绕过配置限制，实现最彻底的语言适配。

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. 复制完成后，别忘了检查一下文件权限。确保运行OnlyOffice服务的用户（比如常见的www-data或者onlyoffice用户）对这个JSON文件有读取权限。

5. 最后，在服务器上执行一个重建缓存的命令，通常是documentserver-generate-allfonts.sh，执行完毕后再重启一下OnlyOffice的相关服务。

6. 大功告成后，怎么验证呢？最稳妥的方式是打开浏览器的无痕模式，然后访问你的OnlyOffice Web端。现在，从各个按钮、悬浮提示，到错误提示信息，应该都已经是完整的中文文本了。