個人開発のGit運用|最小限のブランチ・タグ・バックアップで迷わない
チーム開発のGit運用ルールを調べると、一人で使うには重すぎるものが多いです。とはいえ、まったく使わないと「昨日まで動いていたのに戻せない」という事態になります。個人開発でちょうどいい運用を整理しました。
一人でもGitを使う理由
Gitはチームで開発するための道具と思われがちですが、一人で開発するときこそ助けになる場面があります。
- 戻せる:昨日まで動いていたのに、今日あちこち触ったら動かなくなった。そんなときに、動いていた状態へすぐ戻せます。
- 何を変えたか分かる:「このバグはいつから?」を、変更の履歴からたどれます。
- 試せる:大きな改造を、元のコードを壊さずに試せます。だめなら丸ごと捨てられます。
- バックアップになる:GitHubなどの非公開リポジトリに送っておけば、パソコンが壊れてもコードは残ります。
ここでは、一人で使うのにちょうどいい、最小限のルールを紹介します。
コミットの粒度:「1つの目的」で区切る
コミット(変更の記録)は、「1つの目的が達成できたら1回」を目安にします。
| 良い例 | 避けたい例 |
|---|---|
| 「設定画面にダークモードの切り替えを追加」 | 「いろいろ修正」 |
| 「保存ボタンを2回押すと二重に保存される不具合を修正」 | 1週間分の変更をまとめて1回でコミット |
| 「広告SDKを最新版に更新」 | 機能追加と不具合修正とライブラリ更新を混ぜる |
目的ごとに分けておくと、問題が起きたときに「どの変更が原因か」を絞り込みやすく、その変更だけを取り消すこともできます。メッセージは日本語で問題ありません。半年後の自分が読んで分かるように、「何を」「なぜ」を短く書きます。
git add lib/settings_page.dart
git commit -m "設定画面にダークモードの切り替えを追加"
迷ったら、「動く状態になったらコミット」と覚えておけば十分です。動かない途中の状態でコミットすると、戻したときにまた動かない状態になってしまいます。
ブランチは「main+試すときだけ」で十分
チーム開発では、開発用・リリース用など何本ものブランチを使い分けますが、一人ならもっとシンプルでかまいません。
- main:いつでもビルドできる、動く状態を保つ。普段の小さな修正は直接ここにコミットしてもよい。
- 作業用ブランチ:大きな機能追加や、うまくいくか分からない改造をするときだけ作る。
# 試すためのブランチを作って移動
git switch -c try-new-editor
# ……作業してコミット……
# うまくいったら main に取り込む
git switch main
git merge try-new-editor
git branch -d try-new-editor
# だめだったら、ブランチごと捨てる
git switch main
git branch -D try-new-editor
作業用ブランチがあると、「途中までやったけど、急いで直したいバグが見つかった」ときにも、mainに戻ってバグだけ直してリリースできます。
リリースしたらタグを付ける
ストアに出したバージョンには、タグ(目印)を付けておきます。あとで「ストアに出ている1.2.3のコードはどれ?」となったときに、すぐ取り出せます。
git tag -a v1.2.3 -m "1.2.3(ビルド45)をストアに提出"
git push origin v1.2.3
タグはコミットとは別に送る必要がある点に注意してください(git push だけではタグは送られません)。利用者から「最新版で不具合が出た」と連絡があったとき、前のバージョンのタグとの差分を見れば、何が変わったかがすぐ分かります。
git diff v1.2.2 v1.2.3 --stat
バージョン番号とビルド番号の付け方は、アプリのバージョン番号とビルド番号の付け方にまとめています。
.gitignoreで入れてはいけないものを除外する
リポジトリに入れるのは、ソースコードと、ビルドに必要な設定だけです。次のようなものは .gitignore で除外します。
- ビルドの生成物:Flutterなら
build/、.dart_tool/など。いつでも作り直せるうえ、サイズが大きくなります(Flutterのテンプレートには最初から含まれています)。 - 秘密の情報:署名鍵(
*.jks、*.keystore)、そのパスワードを書いたkey.properties、APIキーを書いた.envなど。 - 個人の環境のファイル:
.DS_Store(macOS)、エディタの設定フォルダなど。
# .gitignore に追加する例
.DS_Store
.env
android/key.properties
*.jks
*.keystore
署名鍵の扱いについては、Androidアプリの署名鍵を失くさないためにで詳しく書いています。
秘密の情報をコミットしてしまったら
APIキーやパスワードを誤ってコミットし、GitHubなどに送ってしまった場合、いちばん大切なのはそのキーを無効にして、新しいものに交換することです。
あとからファイルを削除してコミットしても、過去の履歴には残っています。履歴から消す方法もありますが、一度公開された時点で誰かに読まれている可能性があるため、履歴の削除だけでは安全になりません。公開リポジトリの場合は、数分のうちに自動で収集されることもあります。
- 漏れたキーを、発行元のサービスの管理画面で無効化し、新しいキーを発行する。
- ファイルをGitの管理から外し(
git rm --cached ファイル名)、.gitignoreに追加してコミットする。 - 新しいキーは、コミットされない場所(
.envなど)で管理する。
コミットする前に git status と git diff --staged で、何をコミットしようとしているかを確認する習慣をつけると、こうした事故はかなり減らせます。
困ったときのコマンド早見表
| やりたいこと | コマンド |
|---|---|
| 今の変更内容を見る | git status / git diff |
| 履歴を見る | git log --oneline |
| まだコミットしていない変更を捨てる(ファイル単位) | git restore ファイル名 |
| 作業中の変更を一時的に退避する | git stash(戻すときは git stash pop) |
| 過去のコミットを打ち消すコミットを作る | git revert コミットID |
| 過去の状態を見てみる(見るだけ) | git switch --detach v1.2.2(戻るときは git switch main) |
git reset --hard のように、変更を消してしまうコマンドもあります。慣れないうちは、取り消しには git revert を使うほうが安全です。打ち消しの記録が残るので、間違えてもさらに元に戻せます。
バックアップとしてのリモートリポジトリ
Gitの履歴は、パソコンの中の .git フォルダに保存されています。つまり、パソコンが壊れれば履歴ごと失われます。GitHubなどに非公開(Private)のリポジトリを作り、こまめに git push しておけば、それ自体が自動のバックアップになります。
ただし、リモートリポジトリは「コードのバックアップ」です。前述のとおり、署名鍵やパスワードはリポジトリに入れないので、それらは別の方法でバックアップする必要があります。パソコンの買い替えのときに慌てないよう、何がどこに保存されているかを一度書き出しておくと安心です。
まとめ
- 「1つの目的・動く状態」でコミットし、メッセージに何を・なぜを書く。
- ブランチはmainと、試すときの作業用だけで十分。
- リリースしたらタグを付けて、タグも送る。
- ビルドの生成物と秘密の情報は
.gitignoreで除外する。漏れたキーは交換する。 - 非公開のリモートリポジトリに送って、バックアップを兼ねる。
Gitを使わずに2つのファイルの違いをさっと確かめたいときは、テキスト比較(差分チェック)ツールも使えます。