ソースコード管理とは、コードの変更履歴を記録しておくことで「いつでも過去の状態に戻せる」仕組みのことです。GitHubを安全に使い始めるために、まず押さえておくべきポイントをまとめました。
1. 事故を防ぐセキュリティ対策
機密情報は絶対にコミットしない
パスワード、APIキー、データベースの接続情報などをパブリックリポジトリに公開してしまうと、ボットが数秒以内に検知して悪用する ACL Digital 可能性があります。さらに厄介なのは、コミット履歴はGitに永続的に残るため、ファイルを削除しても以前のリビジョンを参照すれば誰でも閲覧できてしまう Corpsoft 点です。コミット履歴から消すだけでは不十分です。
対策のポイント：
-
.gitignoreを必ず設定する： 環境変数ファイル（.env）やビルド成果物（node_modules/、dist/など）をリポジトリに含めないよう指定します。 - 流出した場合はキー自体を即座に無効化： まずキーを失効させて新しいものを発行するのが最優先です。Gitの履歴からの削除はその後で構いません。 Snyk 削除だけでは手遅れです。
2. わかりやすい履歴を残すルール
コミットの単位は「1機能・1修正」
複数の変更をまとめて1つのコミットにすると、後から原因を追うのが難しくなります。「ログイン画面のレイアウト調整」「ボタンのクリックイベント追加」のように、テーマごとに分けてこまめにコミットする習慣をつけましょう。
何をしたかが伝わるメッセージを書く
「修正」「update」のような一言では、後から（あるいは他の人が）見たときに内容がわかりません。
| ❌ 悪い例 | ✅ 良い例 |
|---|---|
修正 |
Fix: ログインボタンがスマホ画面で崩れる問題を修正 |
update |
Add: ユーザー登録フォームにバリデーションを追加 |
3. ブランチを活用した安全な運用
main ブランチで直接作業しない
動いている本番コード（main ブランチ）に直接変更を加えると、途中のバグで全体が動かなくなるリスクがあります。
-
作業用ブランチを作る： 機能追加やバグ修正ごとに専用のブランチ（例：
feature/login-page、fix/header-bug）を切って作業します。 -
プルリクエスト（PR）を活用する： 作業が終わったら、
mainへのマージ前にプルリクエストを作成します。自分のコードを見直す機会にもなり、ミスを大幅に減らせます。
4. よくあるトラブルの予防策
作業前に必ず最新コードを取り込む（git pull）
チーム開発や複数の端末で作業するとき、ローカルのコードが古いまま編集を始めると「コンフリクト（競合）」が起きやすくなります。作業を始める前には必ず git pull を実行して、リモートの最新状態を取り込んでからコードを書き始めましょう。
まとめ：作業前に確認するチェックリスト
-
.envや不要なファイルが.gitignoreに含まれているか？ -
作業を始める前に
git pullをしたか？ -
mainではなく作業用ブランチでコードを書いているか？ - コミットメッセージに変更内容が具体的に書かれているか？
- [ ]