模块
目录
索引 🔎︎

# 使用参数启动 LibreOffice 软件

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

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

## 从命令行启动 LibreOffice 软件

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

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

3. 在类 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} | 如果可能，强制使用输入筛选器类型。例如: --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 | 加载文档后退出。

### 新建文档参数

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

参数 | 含义
--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 --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 | 将后续文件的文本内容转储到控制台 (隐含「--headless」)。不能与 --convert-to 同时使用。
-env:VAR[=VALUE] | 设置引导参数。例如: 设置非默认用户配置文件路径: -env:UserInstallation=file:///tmp/test

### 忽略的开关

参数 | 含义
-psn | 忽略 (仅 macOS)
-Embedding | 忽略 (COM+ 相关; 仅 Windows)
--nofirststartwizard | 不执行任何操作，仅为向下兼容而接收。
--protector {arg1} {arg2} | 仅在单元测试中使用，应有两个参数。