> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-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 [OPTION]... [TEXNAME[.tex]] [COMMANDS] 或：pdftex [OPTION]... \FIRST-LINE 或：pdftex [OPTION]... &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 对 DVI 文件注释使用 STRING，而不是日期 （对 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 将源特殊命令插入 DVI 文件 -src-specials=WHERE 将源特殊命令插入 DVI 文件的某些位置 。WHERE 是一个以逗号分隔的值 列表：cr display hbox math par parend vbox -synctex=NUMBER 根据 NUMBER 的位生成供预览器使用的 SyncTeX 数据 （详见 `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 [OPTION]... [TEXNAME[.tex]] [COMMANDS] 或：xetex [OPTION]... \FIRST-LINE 或：xetex [OPTION]... &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 对 XDV 文件注释使用 STRING，而不是日期 -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 将源特殊命令插入 XDV 文件 -src-specials=WHERE 将源特殊命令插入 DVI 文件的某些位置 XDV 文件的某些位置。WHERE 是一个以逗号分隔的值 列表：cr display hbox math par parend vbox -synctex=NUMBER 根据 NUMBER 的位生成供预览器使用的 SyncTeX 数据 （详见 `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://overleaf-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.