目录

# Starting LibreOffice Software With Parameters

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

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

## 从命令行启动 LibreOffice 软件

1. Search for Run in the Windows Start menu.

2. Type the following text in the Open text field and click OK.

3. "{install}\program\soffice.com" {parameter}

   Replace {install} with the path to your installation of LibreOffice software (for example, C:\Program Files\LibreOffice). Use soffice.exe instead of soffice.com, when you do not need console (e.g., you do not use command-line interface for headless operations).

1. Open a shell under Linux, *BSD, or macOS platforms.

2. Type the following line of text, then press Return:

   {install}/program/soffice {parameter}

   Replace {install} with the path to your installation of LibreOffice software (for example, /opt/LibreOffice in UNIX)

LibreOffice requires write access to its user profile directory.

## 有效的命令行参数

### 不使用特殊参数

不使用任何参数可打开「启动中心」。

「{文件}」 | 尝试在相应的组件中打开文件 (一个或多个)。
{file} macro://./[Library.Module.MacroName] | 打开文件并应用文件中的指定宏。

### 获取帮助与信息

参数 | 含义
--- | ---
--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=InputFilterName [:InputFilterParam[,param]] | 强制输入筛选器类型 (如果可能)。例如: --infilter="Calc Office Open XML" --infilter="Text (encoded):UTF8,LF,Liberation Mono,en-US". 请参阅用于文件转换的文档筛选器列表。 The list of filter options for Lotus, dBase and Diff files. The list of filter options for CSV files. The list of filter options for PDF files.
--pidfile={file} | 将 soffice.bin 的进程 ID (pid) 存储到「{文件}」。
--display {display} | Sets the DISPLAY environment variable on UNIX-like platforms to the value {display}. This parameter is only supported by the start script for LibreOffice software on UNIX-like platforms.

### 用户/程序界面控制

参数 | 含义
--- | ---
--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 | 初始化完成后退出 (不加载文档)。

Unix and Linux user can invoke LibreOffice with these additional parameters for debugging purposes.

Parameter | Meaning
--- | ---
--record | An enhanced debugger.
--backtrace | Prints the backtrace of the entire stack.
--strace | strace is a diagnostic, debugging and instructional userspace utility for Linux.
--valgrind | Automatically detect many memory management and threading bugs, and profile the program in detail.

The debug options --record, --backtrace, --strace and --valgrind cannot be used together. Please use them one by one.

### 新建文档参数

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

参数 | 含义
--- | ---
--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[=N] | Opens and starts the slideshow of the following presentation documents immediately. Files are closed after the showing. N in the example refers to the slide number and, when it is provided, they start at that slide.

--convert-to OutputFileExtension
[:OutputFilterName
[:OutputFilterParams[,param]]]
[--outdir output_dir]

If --convert-to is used more than once, last value of OutputFileExtension[:OutputFilterName[:OutputFilterParams]] is effective. If --outdir is used more than once, only its last value is effective. In absence of --outdir, current working directory is used for the result. For example:

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

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

The list of filter options for Lotus, dBase and Diff files.

The list of filter options for CSV files.

The list of filter options for PDF files.

--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] | Set a bootstrap variable. For example, to set a non-default user profile path: soffice.com -env:UserInstallation=file:///c:/my-test-profile open LibreOffice.app -env:UserInstallation=file:///tmp/test soffice -env:UserInstallation=file:///tmp/test

### 忽略的开关

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