ノウハウ 開発環境 読了目安 約6分

個人開発の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などに送ってしまった場合、いちばん大切なのはそのキーを無効にして、新しいものに交換することです。

あとからファイルを削除してコミットしても、過去の履歴には残っています。履歴から消す方法もありますが、一度公開された時点で誰かに読まれている可能性があるため、履歴の削除だけでは安全になりません。公開リポジトリの場合は、数分のうちに自動で収集されることもあります。

  1. 漏れたキーを、発行元のサービスの管理画面で無効化し、新しいキーを発行する。
  2. ファイルをGitの管理から外し(git rm --cached ファイル名)、.gitignore に追加してコミットする。
  3. 新しいキーは、コミットされない場所(.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つのファイルの違いをさっと確かめたいときは、テキスト比較(差分チェック)ツールも使えます。