ファイルのコピーが増えてきたら

自分で作ったアプリやWebサイトを少しずつ直していると、フォルダの中に「修正前.html」「修正後.html」「6月10日版」のようなファイルが増えていくことがあります。直す前の状態を残したい気持ちは自然ですが、コピーが増えるほど、どれが最新なのか、どのファイルを編集すればよいのか分かりにくくなります。

AIに相談しながら機能を追加したり、表示を整えたりしている人も、同じような状況になりがちです。作りたいものはあるのに、変更の管理方法までは教わる機会が少ないからです。

こうしたときに役立つのがGitです。ファイルをコピーして残す代わりに、変更を記録しておけば、あとから履歴を確認したり、以前の状態に戻したりできます。GitHubと組み合わせると、記録をオンラインにも置けるため、別の端末で作業したり、誰かに共有したりしやすくなります。

ムチオ
ムチオ
ボク、まずはファイルひとつで試せばいいんだね?
ルミナ
ルミナ
はい。戻す操作をする前に、履歴と対象のファイルを確認してくださいね。いきなり全部を対象にしないほうが、流れをつかみやすいです。

Gitで変更を記録する

Gitは、プロジェクト内のファイルに加えた変更を記録するための仕組みです。たとえば、ボタンの色を変えた、入力欄を追加した、といった区切りで記録を残せます。記録には、変更内容の差分と、変更したときの説明を添えられます。

大切なのは、Gitが編集内容を自動で保存する仕組みではないことです。自分で記録する操作を行って、はじめて履歴に残ります。作業の前後に必要な記録を作る習慣がないと、戻りたい状態が記録されていないこともあります。

最初は、変更をひとまとまりにして、内容が分かる短い説明を付けて記録すると扱いやすくなります。「変更」だけではなく、「問い合わせフォームに確認画面を追加」のように書けば、あとで履歴を見たときに目的を思い出しやすくなります。

また、変更前と変更後の差分を確認すれば、意図しない行まで変わっていないかを見直せます。AIが修正したコードをそのまま反映するのではなく、どのファイルに何が加わったのかを確認する習慣にもつながります。Gitを使えば不具合が起きなくなるわけではありませんが、変更を追いやすくなり、原因を探す手がかりが増えます。

GitHubに置く前に確認したいこと

GitHubは、Gitで記録したプロジェクトをオンラインに置けるサービスです。変更をGitHubにも反映しておけば、パソコンが故障したときに、オンライン上のプロジェクトから作業を再開できる可能性があります。ただし、手元で記録しただけではGitHubには反映されません。アップロードする操作が必要です。

別の端末で作業するときや、他の人に見てもらうときにも、同じプロジェクトを共有しやすくなります。なお、公開範囲には注意が必要です。GitHubのプロジェクトは、設定によって他の人から見える場合があります。共有したくない情報や、サービスの利用に必要な秘密情報を含めないよう確認しましょう。

特に気をつけたいのが、.envファイルやAPIキー、パスワードなどです。こうした情報は、Gitに記録したりGitHubへアップロードしたりしないようにします。.gitignoreという設定ファイルに対象を記載すれば、Gitの管理対象から外せます。ただし、すでに記録した情報を後から除外するだけでは、履歴に残ることがあります。誤って公開した場合は、キーの無効化や再発行なども検討が必要です。

実際の伴走では、アプリを公開する手順だけでなく、デプロイ時に秘密情報をどこで設定するかや、GitHub Actionsで公開作業を自動化する場合の扱いも話題になります。便利な機能を使うほど、何をオンラインに置いてよいか確認することが大切です。

作ったものを次の変更につなげる

Gitの基本を覚えること自体が目的ではありません。自分のサービスやアプリを、安心して少しずつ直していける状態をつくることが目的です。変更の記録を残し、差分を見て、必要なら以前の状態に戻す。その流れが分かると、コピーしたファイルを見比べる負担を減らせます。

一方で、最初の設定やGitHubへの接続、秘密情報の扱いには、つまずきやすい点があります。独学で調べながら進めるうちに、記録したつもりで残っていなかったり、公開範囲を見落としたりすることもあります。作りたいものに集中したいのに、管理方法の確認に時間がかかると、手が止まってしまうかもしれません。

変更の記録や、GitHubへの接続、秘密情報の扱いは、自分で調べながら進めるうちに手が止まりやすいところです。AIで自分のサービスややりたいことを形にしたい方は、実際のプロジェクトを見ながら相談してみる方法もあります。ZELK IT・AI相談所では、GitやGitHubの使い方を含めて、進め方を1対1で一緒に整理しています。