使用参数启动 LibreOffice 软件
通过从命令行启动 LibreOffice 软件,可以指定各种参数。利用这些参数,可以影响软件的性能。仅建议有经验的用户使用命令行参数。

对于一般操作,没有必要使用命令行参数。而某些参数则要求用户具备较多的 LibreOffice 软件技术的背景知识。
从命令行启动 LibreOffice 软件
-
在 Windows 平台下,请从 Windows「开始」菜单选择「运行」,或在 Linux、*BSD 或 macOS 平台打开 shell。
-
在 Windows 下,在「打开」文字字段中输入以下文字并点击「确定」。
-
在类 UNIX 系统中,输入下面一行文字,然后按「回车」:
{安装位置}\program\soffice.exe {参数}{安装位置}/program/soffice {参数}
将 {安装位置} 替换为 LibreOffice 软件的安装路径 (例如,Windows 平台的「C:\Program Files\Office」或 UNIX 平台的「~/office」)
有效的命令行参数
不使用特殊参数
不使用任何参数可打开「启动中心」。
「{文件}」 |
尝试在相应的组件中打开文件 (一个或多个)。 |
「{文件} macro:///[库.模块.宏名称]」 |
打开文件并应用文件中的指定宏。 |
获取帮助与信息
--help / -h / -? |
列出控制台可用的命令行参数。 |
--helpwriter |
打开 LibreOffice Writer 的内置或在线「帮助」。 |
--helpcalc |
打开 LibreOffice Calc 的内置或在线「帮助」。 |
--helpdraw |
打开 LibreOffice Draw 的内置或在线「帮助」。 |
--helpimpress |
打开 LibreOffice Impress 的内置或在线「帮助」。 |
--helpbase |
打开 LibreOffice Base 的内置或在线「帮助」。 |
--helpbasic |
打开 LibreOffice 关于 Basic 编程语言的内置或在线「帮助」。 |
--helpmath |
打开 LibreOffice 关于 Math 的内置或在线「帮助」。 |
--version |
显示 LibreOffice 版本并退出。 |
--nstemporarydirectory |
(仅 macOS 沙盒) 返回当前用户的临时目录路径并退出。替代所有其他参数。 |
常规参数
--quickstart[=no] |
激活[取消激活]「快速启动」服务。只接收一个参数「no」,用于取消激活「快速启动」服务。不加参数则激活该服务。 |
--nolockcheck |
禁用使用当前安装版本的远程实例检测。 |
--infilter={filter} |
如果可能,强制使用输入筛选器类型。例如: |
--pidfile={file} |
将 soffice.bin 的进程 ID (pid) 存储到「{文件}」。 |
--display {display} |
设置类 UNIX 平台的「DISPLAY 环境变量为值 {display}」。该参数仅被类 UNIX 平台 LibreOffice 软件的启动脚本支持。 |
用户/程序界面控制
--nologo |
程序启动时禁用启动屏幕。 |
--minimized |
以最小化方式启动。不显示启动屏幕。 |
--nodefault |
启动时只显示启动屏幕。 |
--invisible |
以隐藏模式启动。 启动徽标和初始程序窗口均将不可见。可以通过 API 控制 LibreOffice 软件,以及控制/打开文档和对话框。 使用该参数,允许 LibreOffice 被「任务管理器」(Windows) 或「kill」命令 (类 UNIX 系统) 终止。 它不能与「-quickstart」一起使用。 如需更多信息,请参阅《LibreOffice 开发者指南》。 |
--headless |
以「无界面模式」启动,此模式允许不通过用户界面使用应用程序。 当外部客户端通过 API 控制应用程序时,可以使用此特殊模式。 |
--norestore |
在发生系统崩溃后禁用重新启动和文件恢复。 |
--safe-mode |
以「安全模式」启动,即临时用全新的用户配置文件启动,有助于恢复损坏的配置。 |
--accept={UNO} |
通知 LibreOffice 软件,在创建「UNO 接收器线程」时使用「UNO 接收字符串」。 UNO-URL 是类似这样的字符串「uno:连接类型,参数;协议名称,参数;对象名称」。 如需更多信息,请参阅《LibreOffice 开发者指南》。 |
--unaccept={UNO-URL} |
关闭通过「--accept={UNO-URL} 创建的接收器。使用 --unaccept=all」可关闭所有打开的接收器。 |
--language={lang} |
使用指定的语言,如果该语言尚未选择应用于 UI。语言必须为合法的 IETF 语言标签。 |
开发者参数
--terminate_after_init |
初始化完成后退出 (不加载文档)。 |
--eventtesting |
加载文档后退出。 |
新建文档参数

这些参数可创建指定类型的空文档。一个命令行中只能使用其中一种。如果参数后指定了文件名,则尝试在指定组件中打开这些文件。
--writer |
启动空白的 Writer 文档。 |
--calc |
启动空白的 Calc 文档。 |
--draw |
启动空白的 Draw 文档。 |
--impress |
启动空白的 Impress 文档。 |
--math |
启动空白的 Math 文档。 |
--global |
启动空白的 Writer 主控文档。 |
--web |
启动空白的 HTML 文档。 |
文件打开参数

这些参数定义如何对待后续的文件名。一个参数之后、下一个参数之前的部分将单独对待。默认行为是打开用于编辑,以及从文档模版新建文档。
-n |
将后续文件视为创建新文档的模版。 |
-o |
将后续文件打开用于编辑,无论是否为模版。 |
--pt {Printername} |
使用打印机 {打印机名称} 打印后续文件并结束。不会出现启动屏幕。 如果文件名含有空格,则必须在名称前后加上引号。 如果多次使用,只有最后一个「{打印机名称}」对所有文档的所有「--pt」命令有效。 此外,「--print-to-file 开关的 --printer-name」参数与 {Printername} 冲突。 |
-p |
使用默认打印机打印后续文件,随后关闭文件。不会出现启动屏幕。 如果文件名含有空格,则必须在名称前后加上引号。 |
--view |
以查看模式 (只读) 打开后续文件。 |
--show |
打开并立即开始后续演示文稿文档的放映。放映结束后将关闭文件。除 Impress 文档外的其他文件将以默认模式打开,无论之前为何模式。 |
--convert-to OutputFileExtension[:OutputFilterName] [--outdir output_dir] |
批量转换文件 (隐含「--headless」)。如果未指定「--outdir」,则当前工作目录将作为「输出目录」。 如果多次使用「--convert-to」,则最后一个 OutputFileExtension[:OutputFilterName] 有效。如果多次使用「--outdir」,最后一次的值有效。例如: --convert-to pdf *.doc |
--print-to-file [--printer-name printer_name] [--outdir output_dir] |
批量将文件打印为文件。如果未指定「--outdir」,则当前工作目录将用作「输出目录」。 如果多次使用「--printer-name」或「--outdir」,只有最后一次给出的值有效。另外,「--pt 开关的 {打印机名称}」与 --printer-name 冲突。例如: --print-to-file *.doc |
--cat |
将后续文件的文本内容转储到控制台 (隐含「--headless」)。不能与 --convert-to 同时使用。 |
-env:VAR[=VALUE] |
设置引导参数。例如: 设置非默认用户配置文件路径: -env:UserInstallation=file:///tmp/test |
忽略的开关
-psn |
忽略 (仅 macOS) |
-Embedding |
忽略 (COM+ 相关; 仅 Windows) |
--nofirststartwizard |
不执行任何操作,仅为向下兼容而接收。 |
--protector {arg1} {arg2} |
仅在单元测试中使用,应有两个参数。 |