发现VSCode或扩展Bug时，应先搜索GitHub仓库确认是否已存在相同问题，避免重复提交；若无，则整理操作系统、VSCode版本、扩展信息、清晰的复现步骤、预期与实际行为及日志截图等必要内容，根据问题类型提交至VSCode官方仓库或对应扩展的GitHub页面，并撰写结构化标题与正文以便开发者快速定位。
发现 VSCode 或某个扩展有 Bug 时，及时报告有助于开发者修复问题、提升使用体验。报告前需要做好信息整理，确保提交的内容清晰有效。
确认是否为已知问题
在提交新问题前，先查看是否已有相同反馈：
- 访问 VSCode 官方 GitHub 仓库（https://github.com/microsoft/vscode）或对应扩展的仓库
- 在 Issues 中用关键词搜索相关错误现象，比如崩溃、卡顿、功能失效等
- 检查是否已有相似 Issue，可点赞或补充信息，避免重复提交
准备必要的信息
有效的 Bug 报告应包含以下内容，帮助开发者快速复现和定位问题：
- 操作系统版本：如 Windows 11、macOS Sonoma、Ubuntu 22.04
- VSCode 版本：通过“帮助”→“关于”查看，例如 1.85.1
- 扩展名称与版本（如果是扩展问题）：可在扩展面板中找到
- 问题描述：清楚说明发生了什么，理想情况下提供操作步骤
- 复现步骤：按顺序列出如何触发该 Bug，例如“打开某文件 → 点击格式化按钮 → 编辑器无响应”
- 预期行为 vs 实际行为：比如“应自动补全代码，但弹出错误提示”
- 错误日志或截图：可从“输出”面板、开发者工具（Help → Toggle Developer Tools）中复制相关错误信息
提交问题到正确的位置
根据问题类型选择合适的提交渠道：
- VSCode 本身的问题：提交到官方仓库 https://github.com/microsoft/vscode/issues
- 某个扩展的问题：前往该扩展的页面，点击“Report Issue”链接，通常会跳转到其 GitHub 仓库
- 如果不确定，可在 VSCode 扩展市场页面找到扩展详情中的“Repository”链接
撰写清晰的问题标题和内容
标题要简洁明确，例如：
- “[Python 扩展] 在保存文件时自动格式化失败，报错 ‘Formatter black is not installed’”
- “远程 SSH 连接后，文件资源管理器频繁刷新”
正文中结构化描述，建议分段落写：复现步骤、预期结果、实际结果、附加信息（日志、截图等）。
基本上就这些。只要提供完整上下文，社区或维护者能更快响应。不复杂但容易忽略细节。
