> ## Documentation Index
> Fetch the complete documentation index at: https://bun.ll1025.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 反馈

> 分享反馈、错误报告和功能请求

以下是如何就 Bug、性能问题或功能请求提交有帮助的问题报告：

<Callout icon="discord">如有一般性问题，请加入 [Discord](https://bun.com/discord)。</Callout>

## 报告问题

<Steps>
  <Step title="升级 Bun">
    使用 `bun upgrade` 将 Bun 升级到最新版本。这可能会解决你的问题，无需提交问题报告。

    ```bash terminal icon="terminal" theme={null}
    bun upgrade
    ```

    你也可以尝试最新的 canary 版本，其中包含尚未发布稳定版的更改和 Bug 修复。

    ```bash terminal icon="terminal" theme={null}
    bun upgrade --canary

    # 恢复到稳定版
    bun upgrade --stable
    ```

    如果升级后问题仍然存在，请继续执行下一步。
  </Step>

  <Step title="查看已有问题">
    在提交新问题之前，请先检查是否已有相关报告。这可以节省大家的时间，并帮助我们专注于解决问题。

    * 🔍 [**搜索已有问题**](https://github.com/oven-sh/bun/issues)
    * 💬 [**查看讨论**](https://github.com/oven-sh/bun/discussions)

    如果找到相关问题，可以在上面添加 👍 表情或补充更多细节，而不是重新提交一个新问题。
  </Step>

  <Step title="报告问题">
    如果没有人报告过该问题，请提交一个新的问题或提出改进建议。

    * 🐞 [**报告 Bug**](https://github.com/oven-sh/bun/issues/new?template=2-bug-report.yml)
    * ⚡ [**提出改进建议**](https://github.com/oven-sh/bun/issues/new?template=4-feature-request.yml)

    请尽可能提供详细信息，包括：

    * 清晰简洁的标题
    * 代码示例或复现步骤
    * 你使用的 Bun 版本（运行 `bun --version`）
    * 问题描述（你预期发生什么，以及实际发生了什么）
    * 你使用的操作系统及版本
          <Note>
            * 对于 macOS 和 Linux：复制 `uname -mprs` 的输出
            * 对于 Windows：在 PowerShell 控制台中复制以下命令的输出：
              `"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"`
          </Note>
  </Step>
</Steps>

Bun 团队会审查该问题并尽快回复你。

***

## 使用 `bun feedback`

`bun feedback` 可以将反馈、错误报告和功能请求直接发送给 Bun 团队。

```bash terminal icon="terminal" theme={null}
bun feedback "喜欢新版本！"
bun feedback report.txt details.log
echo "请为 X 添加文档" | bun feedback --email you@example.com
```

可以通过文本参数、文件路径或管道输入来传递反馈。