GitHubを見る前に
コード管理と秘密情報を分けて考える
GitHubはコード履歴や差分確認に向いています。APIキー、パスワード、DB情報などを置かないこともセットで確認しましょう。
GitHubには何でも保存していいの？
コード管理には便利ですが、秘密情報は入れません。差分を見るページと、入れてはいけないもののページを一緒に確認しましょう。
Beginner
GitHub初級編
GitHub初級では、まず用語と小さな練習リポジトリで、変更を記録する感覚をつかみます。
このページは非公式の実践ガイドです。GitHubの画面や機能、料金、仕様は変わる可能性があります。最新情報が必要な場合は提供元情報を確認してください。
最初に知ること
GitHubを始める前に、publicとprivateの違いを理解します。publicは外から見える可能性があるため、外へ出せない情報や接続情報を入れないようにします。privateでも、チーム共有や権限設定には注意が必要です。
最初は練習用リポジトリを作り、READMEを書き、1つのファイルを追加してコミットするところから始めると理解しやすくなります。
初心者が最初にやる操作
リポジトリを作る、READMEを書く、ファイルを追加する、コミットする、ブランチを作る、変更履歴を見る、Pull Requestの入口を見る、という順番がおすすめです。
GitHub Desktopを使う場合は、手元のファイルとGitHub上のリポジトリの関係を意識します。ブラウザだけで試す場合は、小さなREADME編集から始めると安全です。
初心者がやりがちな失敗
公開してよいか確認せずファイルを置く、何を変えたか分からないコミットを重ねる、ブランチを使わず本体へ直接大きく反映する、Pull Requestを読まずに進める、といった失敗があります。
用語表
| 英語 | 日本語 | 意味 |
|---|---|---|
| repository | リポジトリ | コードやファイルを入れる箱 |
| branch | ブランチ | 本体とは別に作業する分岐 |
| commit | コミット | 変更内容を記録すること |
| pull request | プルリクエスト | 変更を取り込む前に確認してもらう提案 |
| issue | イシュー | タスクや問題点を記録する場所 |
| clone | クローン | リポジトリを手元にコピーすること |
| pull | プル | 最新の変更を取り込むこと |
| push | プッシュ | 手元の変更をGitHubへ送ること |
悪い例 / 良い例
| 悪い例 | 良い例 |
|---|---|
| 英語用語を全部避ける | 英語と日本語をセットで覚える |
| 練習なしで本番リポジトリを触る | 練習リポジトリで試す |
| 何を変えたか分からないコミットにする | コミットメッセージに変更内容を書く |
練習リポジトリを作る時の整理例
GitHub初心者向けに、練習リポジトリで最初に試す手順を作ってください。README作成、ファイル追加、コミット、ブランチ、Pull Requestの入口に分けてください。やってはいけないこと
- 外へ出せない情報や接続情報を通常ファイルに書く
- mainへ大きな変更を直接反映する
- AIレビューだけで完了扱いにする
- リポジトリや作業環境を混ぜる
- 変更後の確認を人間が行わない
確認チェックリスト
- publicとprivateの違いを確認した
- 練習リポジトリで試した
- READMEを書いた
- ファイルを追加した
- コミットした
- ブランチを作った
- Pull Requestの入口を見た
- 外へ出せない情報を置いていない
GitHub基本用語を確認する
GitHubの説明でリポジトリ、コミット、ブランチ、Pull Requestが分かりにくい時は、4つの基本用語を先に確認すると作業の流れを追いやすくなります。
関連ページ
GitHubを実務でどう使うか
GitHubをコードの図書館から、変更履歴、差分確認、Codex作業対象、公開前チェックの記録場所へ広げて使うための具体例です。