ガイド·2 min read
どうすれば…?
よく必要になる作業への短い答え。右のリストから探すか、/ を押して検索してください。
## はじめる
### 既存のフォルダーでバージョン管理を始めたい
```bash
cd my-folder
zev init
zev add .
zev commit -m "最初のバージョン"
```
### Zaryn のプロジェクトを自分のパソコンに持ってきたい
```bash
zev clone owner/project
```
### 自分のプロジェクトを Zaryn に置きたい
```bash
zev login zaryn.xyz --register your-name --email you@example.com # パソコンごとに一度
zev new
zev push
```
## 保存と確認
### 何を変えたか見たい
```bash
zev status # どのファイルか
zev diff # どの行か
```
### 変更の一部だけ保存したい
```bash
zev add src/login.js src/login.css
zev commit -m "ログインフォームを修正"
```
### コミットする内容を確認したい
```bash
zev diff --staged
```
### 履歴を見たい
```bash
zev log --oneline
```
### あるコミットの変更を見たい
```bash
zev show 47bec4f5
```
### 誰がいつその行を変えたか知りたい
```bash
zev blame path/to/file
```
## 取り消す
### ファイルへの変更を捨てたい
```bash
zev restore path/to/file
```
ファイルは最後のコミットの状態に戻ります。捨てた変更は元に戻せないので、迷ったら先に stash してください。
### コミットしていない変更をすべて捨てたい
```bash
zev restore .
```
### ステージを取り消したい(間違えて add した)
```bash
zev restore --staged path/to/file
```
### 変更を一時的に退避したい
```bash
zev stash save "作業中の内容"
zev stash pop
```
### 削除したファイルを戻したい
```bash
zev restore path/to/file
```
### 古いバージョンを見たい
zev はまだフォルダーを古いコミットに切り替えられませんが、ファイルを変えずにどのコミットでも見られます:
```bash
zev show <commit>
zev diff <commit> HEAD -- file
```
### 作ってしまったコミットを取り消したい
zev はコミットを書き換えません。それを打ち消す新しいコミットを作ってください。`zev diff <commit>~1 <commit>` でそのコミットが何を変えたかが正確にわかります。
## ファイル
### ファイルを削除したい
```bash
zev rm path/to/file
zev commit -m "古いファイルを削除"
```
### ファイルの名前を変えたい・移動したい
```bash
mv old-name.txt new-name.txt
zev add old-name.txt new-name.txt
zev commit -m "名前を変更"
```
### ファイルを残したまま追跡をやめたい
```bash
zev rm --cached .env
echo ".env" >> .zevignore
zev add .zevignore
zev commit -m ".env の追跡をやめる"
```
### ファイルを無視したい(ビルド結果、ログ、秘密情報)
プロジェクトの一番上のフォルダーに `.zevignore` を作り、1行に1つパターンを書きます:
```text
node_modules/
dist/
*.log
.env
```
## ブランチ
### main に触れずに作業したい
```bash
zev checkout -b my-feature
```
### 作業途中でブランチを切り替えたい
```bash
zev stash
zev checkout other-branch
zev checkout my-feature
zev stash pop
```
### ブランチを main に取り込みたい
```bash
zev checkout main
zev merge my-feature
```
### マージの衝突を解決したい
```bash
zev merge my-feature --resolve
# 表示されたファイルを編集: <<<<<<< と >>>>>>> の間で残したいものを残し、印を消す
zev add .
zev merge --continue
```
詳しくは [ブランチとマージ](/docs/ja/branches)。
### リリースに印をつけたい
```bash
zev tag v1.0
```
## 共有と共同作業
### チームの最新の変更を取り込みたい
```bash
zev pull
```
### コミットを送りたい
```bash
zev push
```
### マージ前にレビューを頼みたい
```bash
zev checkout -b fix-header
zev commit -m "スマホでのヘッダーを修正"
zev push
zev pr
```
### push できないプロジェクトに貢献したい
```bash
zev fork-repo owner/project --clone
cd project
zev push
zev pr
```
### リポジトリを削除する
リポジトリを開いて **⚙ Settings** を押します(トポロジーリポジトリはネットワーク概要から)。下の **Danger zone** でリポジトリ名を入力し、**Delete this repository** を押します。履歴、ブランチ、プルリクエスト、課題、保存されたすべてのファイルが削除され、元に戻せません。所有者と、その組織のオーナーまたは管理者が行えます。
## zev 自体
### zev を更新したい
```bash
zev self update
```
apt、dnf、zypper、pacman でインストールした場合は、システムの通常の更新で更新されます。
### 忘れたコマンドを探したい
```bash
zev help
zev help stash
```
または [すべてのコマンド](/docs/ja/commands) を見てください。