跳到主要内容

详细的错误报告

将从 CLI 遇到的错误中收集的数据写入到文件。CLI 中详细错误报告的工作流程如下:

  • 如果 CLI 必须异常结束正在运行的 CLI 命令和脚本命令,将在 CLI 完成之前收集并保存错误数据。

  • CLI 通过将数据写入标准文件名来保存错误数据。

  • CLI 自动将数据保存到文件中。不需要特殊的命令行选项来保存错误数据。

  • 您无需执行任何操作即可将错误数据保存到文件。

  • CLI 没有任何配置来防止覆盖包含错误数据的现有版本文件。

对于错误处理,显示以下两种类型的错误:

  • 终端错误或可能输入的语法错误

  • 由于操作错误发生的异常

当 CLI 遇到任何类型的错误时,CLI 会将错误描述信息直接写入命令行并设置返回码。根据返回码,CLI 还可能会写入关于哪个终端导致错误的其他信息。CLI 还会写入关于命令语法要求的信息,帮助您发现可能输入的任何语法错误。

在命令运行期间发生异常时,CLI 会捕获错误。在命令处理结束时(处理完命令后,信息已写入命令行),CLI 自动将错误信息保存到文件中。

用于保存错误信息的文件名称为 excprpt.txt 。CLI 尝试将 excprpt.txt 文件置于系统属性 devmgr.datadir 指定的目录中。如果由于任何原因导致 CLI 无法将该文件放入 devmgr.datadir 指定的目录中,则 CLI 会将 excprpt.txt 文件保存到运行 CLI 的目录中。不能更改文件名或位置。每次发生异常时,将覆盖 Excprpt.txt 文件。如果想要将信息保存在 excprpt.txt 文件中,必须将信息拷贝到新文件或新目录中。