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

# bisect

> バグを入れたコミットを見つける

`bisect` は、バグを入れたコミットを探します。バグがあるコミットと、それより古い「バグがない」コミットの真ん中をチェックアウトし、印を付けた側で同じことを繰り返します。

検索は各コミットの1つ前のコミットをたどるので、1本の履歴の上だけを見ます。バグがマージで入った場合、結果はそのマージのコミットです。もう一方のブランチをチェックアウトして、そこで再度 bisect してください。

```bash theme={null}
dv bisect start [<bad> [<good>...]]
dv bisect bad [<ref>]
dv bisect good [<ref>...]
dv bisect skip [<ref>...]
dv bisect reset [<ref>]
dv bisect log
dv bisect run <command> [<arg>...]
```

検索を始め、今のコミットを「バグがある」と印し、それより古い「バグがない」コミットを指定します。

```bash theme={null}
dv bisect start
dv bisect bad
dv bisect good <older-commit>
```

ファイルを確認してから、結果を印します。

```bash theme={null}
dv bisect good
dv bisect bad
```

`dv bisect run` は、各ステップでコマンドを実行します。

* 終了コード 0 は、このコミットにバグがないという意味です。
* 終了コード 125 は、テストできないコミットを飛ばします。
* 終了コード 1 から 127 は、このコミットにバグがあるという意味です。
* 終了コード 128 以上は、検索を止めます。

コマンドはワークスペースのルートで動きます。`DV_BISECT_COMMIT` は、今テストしているコミットです。`-` で始まる引数の前には `--` を置いてください。コマンドが作ったファイルは、次のチェックアウトの前に捨てられます。

```bash theme={null}
dv bisect run -- ./test.sh
```

最初のテストの前に、コミットしていない変更があると拒否します。手元の編集が、テスト中のコミットを隠さないためです。

`dv bisect reset` は検索を止め、開始時のブランチまたはコミットに戻します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.