> ## 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.

# checkout

> Diversion の checkout コマンドリファレンスで、ブランチを切り替え、バージョンを効率的に管理しましょう。

現在のワークスペースにブランチ、コミット、またはタグをチェックアウトします。

```bash theme={null}
dv checkout <ref> [--take-changes] [--shelve-changes] [--discard-changes] [--apply-shelf] [--ignore-shelf] [--nowait]
```

`<ref>` は唯一必須のパラメータで、選択肢は次のとおりです:

ブランチをチェックアウトする場合は、`<branch_name>` または `<branch_id>` 。

コミットやタグをチェックアウトする場合は、`<commit_id>` または `<tag_id>` 。

チェックアウト時に、ローカルの保留中の変更や、送られてきたシェルフ済み変更がある場合があります。それぞれの場合に何をするかを指定できます:

`[--take-changes]` ワークスペースに変更がある場合、それらをチェックアウト先に持っていきます。

`[--shelve-changes]` ワークスペースに変更がある場合、後で使うためにシェルフに保存します。

`[--discard-changes]` ワークスペース内の変更を破棄します。

`[--apply-shelf]` チェックアウトするブランチに以前にシェルフされた変更が含まれている場合、チェックアウト後にそれらを適用します。

`[--ignore-shelf]` チェックアウトするブランチに以前にシェルフされた変更が含まれている場合、それらを無視し、適用を促さないようにします。

デフォルトでは、checkout はチェックアウトされたファイルがローカルワークスペースへの同期を完了するのを待ちます:

`[--nowait]` ローカルファイル同期の完了を待たずにすぐに戻ります。