使用参数启动 LibreOffice 软件

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

note

对于一般操作,没有必要使用命令行参数。而某些参数则要求用户具备较多的 LibreOffice 软件技术的背景知识。


从命令行启动 LibreOffice 软件

  1. 在 Windows 平台下,请从 Windows「开始」菜单选择「运行」,或在 Linux、*BSD 或 macOS 平台打开 shell。

  2. 在 Windows 下,在「打开」文字字段中输入以下文字并点击「确定」。

  3. 在类 UNIX 系统中,输入下面一行文字,然后按「回车」:

    将「{安装位置}」替换为 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}

强制输入筛选器类型 (如果可能)。例如:

--infilter="Calc Office Open XML"

--infilter="Text (encoded):UTF8,LF,Liberation Mono,en-US".

--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

加载文档后退出。


新建文档参数

note

这些参数可创建指定类型的空文档。一个命令行中只能使用其中一种。如果参数后指定了文件名,则尝试在指定组件中打开这些文件。


参数

含义

--writer

启动空白的 Writer 文档。

--calc

启动空白的 Calc 文档。

--draw

启动空白的 Draw 文档。

--impress

启动空白的 Impress 文档。

--math

启动空白的 Math 文档。

--global

启动空白的 Writer 主控文档。

--web

启动空白的 HTML 文档。


文件打开参数

note

这些参数定义如何对待后续的文件名。一个参数之后、下一个参数之前的部分将单独对待。默认行为是打开用于编辑,以及从文档模版新建文档。


参数

含义

-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

--convert-to pdf:writer_pdf_Export --outdir /home/user *.doc

--convert-to "html:XHTML Writer File:UTF8" *.doc

--convert-to "txt:Text (encoded):UTF8" *.doc

请参阅用于文件转换的文档筛选器列表

--print-to-file [--printer-name printer_name] [--outdir output_dir]

批量将文件打印为文件。如果未指定「--outdir」,则当前工作目录将用作「输出目录」。

如果多次使用「--printer-name」或「--outdir」,只有最后一次给出的值有效。另外,「--pt 开关的「{打印机名称}」与 --printer-name」冲突。例如:

--print-to-file *.doc

--print-to-file --printer-name nasty_lowres_printer --outdir /home/user *.doc

--cat

将筛选器「txt:Text」应用于以下文本文档, 并将文本内容转储到控制台 (隐含「--headless」)。不能与「--convert-to」一起使用。

-env:VAR[=VALUE]

设置引导参数。例如: 设置非默认用户配置文件路径:

-env:UserInstallation=file:///tmp/test


忽略的开关

参数

含义

-psn

忽略 (仅 macOS)

-Embedding

忽略 (COM+ 相关; 仅 Windows)

--nofirststartwizard

不执行任何操作,仅为向下兼容而接收。

--protector {arg1} {arg2}

仅在单元测试中使用,应有两个参数。


请支持我们!