诊断
Biome 的诊断信息包含丰富的信息，它们通常会提供理解错误和解决问题所需的所有信息。
诊断不仅用于报告错误，还用于提供结构化信息、警告和提示。
本页面详细介绍了诊断可能包含的所有信息。了解诊断的各个组成部分可以帮助您识别重要信息及其背后的”秘密”。
诊断严重程度
Section titled “诊断严重程度”诊断的严重程度会影响 CLI 的行为。例如，错误诊断会强制 CLI 以错误代码退出。
致命错误（Fatal）
Section titled “致命错误（Fatal）”致命诊断使用红色文本。当 Biome 内部发生意外错误时通常会发出此类诊断。与普通错误相比，它们带有致命标签。
FATAL ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
⚠ Biome exited as this error could not be handled and resulted in a fatal error. Please report it if necessary.
错误（Error）
Section titled “错误（Error）”错误诊断使用红色文本。通常应该处理这些错误，因为当 CLI 遇到它们时会返回错误代码。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
警告（Warning）
Section titled “警告（Warning）”警告诊断使用黄色文本。通常也应该处理这些警告。警告不是阻断性问题，不会阻止 CLI 正常工作。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
信息（Information）
Section titled “信息（Information）”信息诊断使用绿色文本。它们提供有用的信息，但不会阻断 CLI 的执行。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ℹ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
标签可以看作是附加到诊断上的元数据，它们会以不同方式影响客户端。
详细（Verbose）
Section titled “详细（Verbose）”详细诊断通常默认隐藏。通过 CLI，您可以使用 --verbose 选项来显示这些诊断。
VERBOSE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
内部（Internal）
Section titled “内部（Internal）”当发生内部错误时会发出内部诊断。用户看到此类诊断时通常被鼓励提交 bug 报告。
INTERNAL ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
⚠ This diagnostic was derived from an internal Biome error. Potential bug, please report it if necessary.
可修复（Fixable）
Section titled “可修复（Fixable）”可修复诊断适用于那些用户可以自行修复的情况。它们通常用于具有代码操作的 lint 诊断。
FIXABLE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
废弃（Deprecated）
Section titled “废弃（Deprecated）”包含已废弃代码的诊断
DEPRECATED ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
分类用于对诊断进行分组。可选地，分类可以包含链接，例如属于 lint 规则的分类，如下例所示。
此诊断属于 "check" 分类，这意味着在执行 check 命令时会发出该诊断：
check ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
带链接的分类
Section titled “带链接的分类”此诊断属于 "lint/a11y/noAccessKey" 分类。该链接会将用户带到 lint 规则 noAccessKey 的网页。
lint/a11y/noAccessKey ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
诊断可以包含 “位置” 信息。位置由三个可选部分组成：
- 资源，即发出诊断的来源；
- 文件的源代码；
- 跨度(或文本范围)，通常是文件内的 行 和 列 。
诊断文件路径
Section titled “诊断文件路径”文件路径通常是您在诊断左上角看到的第一条信息。
path/to/file.js ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
这展示了与文件关联的源代码是如何显示的。请注意这里并未显示行列号。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
> 1 │ Some source code
│ ^^^^^
诊断行号和列号
Section titled “诊断行号和列号”行 和 列 通常打印在文件路径旁边，并且只有在有关联的源代码时才会显示。
path/to/file.txt:1:6 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
> 1 │ Some source code
│ ^^^^^^
当诊断在 IDE 的终端中打印时，您可以点击 path/to/file.js:2:2，IDE 将打开相关文件并将光标定位在跨度的开始位置。
path/to/file.js:2:2 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
1 │ function name() {
> 2 │ return 'lorem'
│ ^^^^^^^^^^^^^^
3 │ }
此外，我们的诊断还可以存储建议。建议是在原始消息之后追加的额外消息。
这些建议有不同的类型和形式。通常情况下建议总是会被打印出来，除非它们是 详细建议。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
✖ This log is an error.
ℹ This log is a warning
ℹ This log is an information
This log doesn't have any category. Below, you'll have a command
$ biome command
Below, a group.
I am a group
ℹ First message of a group.
ℹ Second message of a group.
Below, a list.
- First item
- Second item
Below, a diff.
- Old·code
+ New·code
Below, a code frame.
> 1 │ Lorem
│ ^^^
2 │ Ipsum
Sponsored by
Copyright (c) 2023-present Biome Developers and Contributors.