> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/zh-cn/geng-duo-zhu-ti/44-tex-engine-command-line-options-for-pdftex-xetex-and-luatex.md). # pdfTeX、XeTeX 和 LuaTeX 的 TeX 引擎命令行选项 ## pdfTeX 版本 1.40.19 要查看 pdfTeX 命令行选项的摘要，请运行以下命令 ``` pdftex --help ``` 以查看此列表： ``` 用法：pdftex [选项]... [TEXNAME[.tex]] [命令] 或：pdftex [选项]... \FIRST-LINE 或：pdftex [选项]... &FMT ARGS 对 TEXNAME 运行 pdfTeX，通常会创建 TEXNAME.pdf。 读取 TEXNAME 后，所有剩余的 COMMANDS 都将作为 pdfTeX 输入进行处理。 如果 TEXNAME 的第一行是 %&FMT，且 FMT 是一个现有的 .fmt 文件， 则使用它。否则使用 `NAME.fmt'，其中 NAME 是调用程序时的名称， 最常见的是 `pdftex'。 或者，如果第一个非选项参数以反斜杠开头， 将所有非选项参数解释为一行 pdfTeX 输入。 或者，如果第一个非选项参数以 & 开头， 则把下一个词当作要读取的 FMT，覆盖其他所有设置。任何 剩余参数将按上述方式处理。 如果没有指定参数或选项，则提示输入。 -draftmode 启用草稿模式（不生成输出 PDF） -enc 启用 encTeX 扩展，例如 \mubyte -etex 启用 e-TeX 扩展 [-no]-file-line-error 禁用/启用 file:line:error 风格的消息 -fmt=FMTNAME 使用 FMTNAME 而非程序名称或 %& 行 -halt-on-error 在第一个错误处停止处理 -ini 作为 pdfinitex 运行，用于转储格式；在以下情况下会隐式 为真：程序名称是 `pdfinitex' -interaction=STRING 设置交互模式（STRING=batchmode/nonstopmode/ scrollmode/errorstopmode） -ipc 除常规输出文件外，还将 DVI 输出发送到套接字 输出文件 -ipc-start 与 -ipc 相同，并且在另一端启动服务器 -jobname=STRING 将作业名称设为 STRING -kpathsea-debug=NUMBER 根据以下内容设置路径搜索调试标志 NUMBER 的各个位 [-no]-mktex=FMT 禁用/启用 mktexFMT 生成（FMT=tex/tfm/pk） -mltex 启用 MLTeX 扩展，例如 \charsubdef -output-comment=STRING 使用 STRING 作为 DVI 文件注释，而非日期 （对 PDF 无效） -output-directory=DIR 使用现有的 DIR 作为写入文件的目录 -output-format=FORMAT 使用 FORMAT 作为作业输出；FORMAT 为 `dvi' 或 `pdf' [-no]-parse-first-line 禁用/启用对输入文件第一行的解析 -progname=STRING 将程序（及 fmt）名称设为 STRING -recorder 启用文件名记录器 [-no]-shell-escape 禁用/启用 \write18{SHELL COMMAND} -shell-restricted 启用受限的 \write18 -src-specials 将源代码 special 插入 DVI 文件 -src-specials=WHERE 在特定位置插入源代码 special 到 DVI 文件中。WHERE 是以逗号分隔的值 列表：cr display hbox math par parend vbox -synctex=NUMBER 根据以下内容为预览器生成 SyncTeX 数据 NUMBER 的各个位（详见 `man synctex'） -translate-file=TCXNAME 使用 TCX 文件 TCXNAME -8bit 默认使所有字符均可打印 -help 显示此帮助并退出 -version 输出版本信息并退出 pdfTeX 主页： 将错误报告发送至 pdftex@tug.org。 ``` ## LuaTeX 版本 1.08.0 要查看 LuaTeX 命令行选项的摘要，请运行以下命令 ``` luatex --help ``` 以查看此列表： ``` 用法：luatex --lua=FILE [OPTION]... [TEXNAME[.tex]] [COMMANDS] 或者：luatex --lua=FILE [OPTION]... \FIRST-LINE 或者：luatex --lua=FILE [OPTION]... &FMT ARGS 在 TEXNAME 上运行 LuaTeX，通常会生成 TEXNAME.pdf。 在读取 TEXNAME 之后，任何剩余的 COMMANDS 都会作为 luatex 输入来处理。 或者，如果第一个非选项参数以反斜杠开头， luatex 会将所有非选项参数解释为一行输入。 或者，如果第一个非选项参数以 & 开头， 则把下一个词当作要读取的 FMT，覆盖其他所有设置。任何 剩余参数将按上述方式处理。 如果没有指定参数或选项，则提示输入。 以下常规选项可用： --credits 显示致谢并退出 --debug-format 启用格式调试 --draftmode 启用草稿模式（不生成输出 PDF） --[no-]file-line-error 禁用/启用 file:line:error 风格消息 --[no-]file-line-error-style --[no-]file-line-error 的别名 --fmt=FORMAT 加载格式文件 FORMAT --halt-on-error 在首次错误时停止处理 --help 显示帮助并退出 --ini 处于 iniluatex 模式，用于转储格式 --interaction=STRING 设置交互模式（STRING=batchmode/nonstopmode/scrollmode/errorstopmode） --jobname=STRING 将作业名设置为 STRING --kpathsea-debug=NUMBER 根据 NUMBER 的各位设置路径搜索调试标志 --lua=FILE 加载并执行一个 lua 初始化脚本 --[no-]mktex=FMT 禁用/启用 mktexFMT 生成（FMT=tex/tfm） --nosocket 禁用 lua socket 库 --output-comment=STRING 使用 STRING 作为 DVI 文件注释，而不是日期（对 PDF 无效） --output-directory=DIR 使用现有 DIR 作为写入文件的目录 --output-format=FORMAT 使用 FORMAT 作为作业输出；FORMAT 为 'dvi' 或 'pdf' --progname=STRING 将程序名设置为 STRING --recorder 启用文件名记录器 --safer 禁用容易被利用的 lua 命令 --[no-]shell-escape 禁用/启用系统命令 --shell-restricted 将系统命令限制为 texmf.cnf 中给出的命令列表 --synctex=NUMBER 启用 synctex（参见 man synctex） --utc 将初始化时间设为 UTC --version 显示版本并退出 可通过特殊开关获得替代行为模型 --luaonly 运行一个 lua 文件，然后退出 --luaconly 对 lua 文件进行字节编译，然后退出 --luahashchars 当前 Lua 解释器用于字符串哈希的位 有关启动过程的更多信息，请参阅参考手册。 将错误报告发送到 dev-luatex@ntg.nl。 ``` ## XeTeX 版本 0.99999 要查看 XeTeX 命令行选项的摘要，请运行以下命令 ``` xetex --help ``` 以查看此列表： ``` 用法：xetex [选项]... [TEXNAME[.tex]] [命令] 或：xetex [选项]... \FIRST-LINE 或：xetex [选项]... &FMT ARGS 对 TEXNAME 运行 XeTeX，通常会创建 TEXNAME.pdf。 读取 TEXNAME 后，所有剩余的 COMMANDS 都将作为 XeTeX 输入进行处理。 如果 TEXNAME 的第一行是 %&FMT，且 FMT 是一个现有的 .fmt 文件， 则使用它。否则使用 `NAME.fmt'，其中 NAME 是调用程序时的名称， 最常见的是 `xetex'。 或者，如果第一个非选项参数以反斜杠开头， 将所有非选项参数解释为一行 XeTeX 输入。 或者，如果第一个非选项参数以 & 开头， 则把下一个词当作要读取的 FMT，覆盖其他所有设置。任何 剩余参数将按上述方式处理。 如果没有指定参数或选项，则提示输入。 -etex 启用 e-TeX 扩展 [-no]-file-line-error 禁用/启用 file:line:error 风格的消息 -fmt=FMTNAME 使用 FMTNAME 而非程序名称或 %& 行 -halt-on-error 在第一个错误处停止处理 -ini 作为 xeinitex 运行，用于转储格式；在以下情况下会隐式 为真：程序名称是 `xeinitex' -interaction=STRING 设置交互模式（STRING=batchmode/nonstopmode/ scrollmode/errorstopmode） -jobname=STRING 将作业名称设为 STRING -kpathsea-debug=NUMBER 根据以下内容设置路径搜索调试标志 NUMBER 的各个位 [-no]-mktex=FMT 禁用/启用 mktexFMT 生成（FMT=tex/tfm） -mltex 启用 MLTeX 扩展，例如 \charsubdef -output-comment=STRING 使用 STRING 作为 XDV 文件注释，而非日期 -output-directory=DIR 使用现有的 DIR 作为写入文件的目录 -output-driver=CMD 使用 CMD 作为 XDV 至 PDF 驱动程序，而非 xdvipdfmx -no-pdf 生成 XDV（扩展 DVI）输出，而非 PDF [-no]-parse-first-line 禁用/启用对输入文件第一行的解析 -papersize=STRING 将 PDF 介质尺寸设为 STRING -progname=STRING 将程序（及 fmt）名称设为 STRING -recorder 启用文件名记录器 [-no]-shell-escape 禁用/启用 \write18{SHELL COMMAND} -shell-restricted 启用受限的 \write18 -src-specials 将源代码 special 插入 XDV 文件 -src-specials=WHERE 在特定位置插入源代码 special 到 XDV 文件中。WHERE 是以逗号分隔的值 列表：cr display hbox math par parend vbox -synctex=NUMBER 根据以下内容为预览器生成 SyncTeX 数据 NUMBER 的各个位（详见 `man synctex'） -translate-file=TCXNAME（已忽略） -8bit 使所有字符均可打印，不使用 ^^X 序列 -help 显示此帮助并退出 -version 输出版本信息并退出 将错误报告发送至 xetex@tug.org。 ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/latex/zh-cn/geng-duo-zhu-ti/44-tex-engine-command-line-options-for-pdftex-xetex-and-luatex.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.