Skip to main content

诊断集成

itBuilder 提供与 VSCode 问题面板的智能集成，允许 AI 助手理解并帮助修复由语言服务器、代码检查工具和其他诊断提供程序检测到的代码错误、警告和其他问题。

概述​

诊断功能与 VSCode 的诊断系统无缝集成，为代码问题提供上下文感知的协助。当您编辑代码或遇到问题时，itBuilder 可以自动检测并帮助解决这些问题。

核心功能​

  • 自动错误检测：捕获代码编辑过程中引入的新错误
  • 上下文感知修复：基于诊断信息提供针对性修复
  • 工作区问题提及：通过简单提及访问所有工作区诊断
  • 智能过滤：为不同上下文使用预定义的严重性级别

主要功能​

1. 自动错误检测​

当 itBuilder 编辑文件时，它会自动：

  • 在编辑前捕获诊断信息
  • 等待编辑后诊断信息更新
  • 检测由更改引入的新问题
  • 仅报告新错误（而非预先存在的问题）

这确保您能立即了解代码更改引入的任何问题，从而快速解决。

2. 工作区问题提及​

用户可以在消息中包含 @problems 来：

  • 获取工作区错误和警告的完整列表
  • 为调试任务提供上下文
  • 请求修复特定问题

使用示例：

@problems 修复我项目中的所有 TypeScript 错误

有关使用 @problems 的更多详细信息，请参阅上下文提及。

3. 代码操作集成​

当光标位置存在诊断信息时：

  • "使用 itBuilder 修复"操作出现在快速修复菜单中
  • 在修复请求中包含诊断详细信息
  • 基于错误上下文提供针对性解决方案

在代码操作中了解更多关于此集成的信息。

4. 智能严重性过滤​

不同功能使用不同的严重性过滤器来提供最相关的信息：

  • 工作区问题提及：显示错误和警告
  • 自动检测：仅显示错误（避免干扰）
  • 上下文感知：不同功能使用不同的硬编码严重性过滤器

严重性级别​

诊断系统识别 VSCode 的四个严重性级别：

级别值描述工作区问题自动检测
错误0语法错误、类型错误、破坏性问题✅ 包含✅ 包含
警告1代码质量问题、弃用、样式违规✅ 包含❌ 不包含
信息2建议、提示、信息性消息❌ 不包含❌ 不包含
提示3次要建议、重构机会❌ 不包含❌ 不包含

为什么使用不同的过滤器？​

  • 工作区问题（@problems）：包含错误和警告，在明确请求时为您提供代码健康状况的完整图景
  • 自动检测：仅包含错误，避免用非关键问题中断您的工作流程

有效使用诊断​

调试会话​

开始调试会话时，包含 @problems 为 itBuilder 提供完整上下文：

@problems 帮助我调试为什么我的应用程序崩溃

代码审查​

使用诊断确保代码质量：

@problems 审查我的代码并修复任何代码检查问题

重构​

让诊断指导安全重构：

我想重构这个函数。@problems 显示需要解决的当前问题。

与其他功能的集成​

代码操作​

诊断为 VSCode 灯泡菜单中出现的上下文感知代码操作提供动力。当存在错误时，您会看到包含特定诊断信息的"修复代码"选项。

上下文提及​

@problems 提及提供了一种便捷的方式，可以在不手动复制错误消息的情况下在对话中包含所有工作区诊断。

自动错误报告​

当 itBuilder 编辑文件时，引入的任何新错误都会在响应中自动报告，帮助在整个编辑过程中维护代码质量。

最佳实践​

  1. 使用 @problems 获取上下文：调试时，始终包含 @problems 为 itBuilder 提供当前问题的完整可见性

  2. 优先处理错误：在警告之前专注于修复错误，因为错误通常阻止代码运行

  3. 利用代码操作：使用快速修复菜单对特定诊断进行针对性修复

  4. 监控自动检测：注意编辑后报告的新错误，及早发现问题

  5. 与其他工具结合：将诊断与其他 itBuilder 功能（如代码库搜索和文件提及）结合使用，进行全面的问题解决

故障排除​

诊断不出现​

  • 确保您的语言服务器或代码检查工具配置正确并正在运行
  • 检查文件类型是否由您的诊断提供程序支持
  • 验证 VSCode 的问题面板是否显示问题

@problems 不显示任何内容​

  • 确认问题面板中确实存在问题
  • 检查您是否在正确的工作区中
  • 某些诊断提供程序可能需要时间初始化

自动检测遗漏错误​

  • 仅报告新错误（由编辑引入）
  • 预先存在的错误不会在自动检测中显示
  • 使用 @problems 查看所有当前问题

相关功能​