命令行参数

命令行参数记录在 rustc book 中。 所有稳定的参数都应在此处记录。不稳定的参数应记录在 unstable book 中。

有关添加新命令行参数的过程的详细信息,请参见 forge guide for new options

指南

  • 参数应彼此正交。例如,如果我们有多个操作,如 foobar ,具有生成 json 的变体,则添加额外的 --json 参数比添加 --foo-json--bar-json 更好。
  • 避免使用带有 no- 前缀的参数。相反,使用 parse_bool 函数,比如 -C embed-bitcode=no
  • 考虑参数被多次传递时的行为。在某些情况下,应该(按顺序)累积值。在另一些情况下,后面的参数应覆盖前面的参数(例如,lint-level 参数)。如果多个参数的含义太模糊,那么一些参数(比如 -o )应该生成一个错误。
  • 如果仅为了编译器脚本更易于理解,请始终为选项提供长的描述性名称。
  • --verbose 参数用于向 rustc 的输出中添加详细信息。例如,将其与 --version 参数一起使用可提供有关编译器代码哈希值的信息。
  • 实验性参数和选项必须放在 -Z unstable-options 后面。