GitHubの使い方リポジトリ作成からプルリクエストまで
GitHubの使い方を、リポジトリ作成・ブランチ・コミット・プルリクエスト・マージの基本の流れで初心者向けに整理します。公開範囲の設定ミスなど注意点も解説します。
公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて
GitHubの使い方とは
GitHub とは、Git で管理するソースコードや文書を保存し、共有し、共同で編集するためのサービスです。GitHub の公式ドキュメントには、はじめての人向けの「Hello World」チュートリアルがあり、リポジトリ、ブランチ、コミット、プルリクエストという、基本的な流れを学べます。
現在では、ソフトウェア開発だけでなく、ドキュメント管理、チームのタスク管理、自動化にも使われています。SaaS やAIツールの多くが、公式のサンプルコードやドキュメントを GitHub で公開しているため、使い方を知っておくと情報収集にも役立ちます。
基本(用語と流れ)
| 用語 | 意味 |
|---|---|
| リポジトリ | プロジェクトのファイルと履歴を入れる箱 |
| ブランチ | 本流に影響させず、作業するための枝 |
| コミット | 変更内容の記録(メッセージ付き) |
| プルリクエスト | 変更を本流に取り込んでよいか提案し、レビューを受ける仕組み |
| マージ | 承認された変更を、本流に統合すること |
| Issue | 課題や要望を書いて、議論と追跡をする場所 |
公式の Hello World では、次の5つの手順が示されています。
| 手順 | 内容 |
|---|---|
| 1 | リポジトリを作成する(README を含める) |
| 2 | ブランチを作成する(元の版に影響しない作業場所) |
| 3 | ファイルを変更して、コミットする |
| 4 | プルリクエストを作成し、変更内容を提案する |
| 5 | マージして、使い終わったブランチを削除する |
GitHubの使い方の具体例
チームで文書を直す場面を例に、役割を整理します。
| 場面 | GitHub での扱い |
|---|---|
| 誤字を見つけた | ブランチを作って修正し、プルリクエストを出す |
| 修正を確認してほしい | レビュー担当者を指定する |
| 直してほしい点があった | プルリクエスト上のコメントで指摘を受ける |
| 要望を残したい | Issue を作って、内容を共有する |
| 修正がまとまった | マージして、本流に反映する |
変更の履歴が残るため、誰が、いつ、なぜ変えたかを後から確認できます。口頭やメールだけの修正と比べ、確認の漏れや、元の状態に戻したいときの手間が減ります。
プルリクエストでは、変更前と変更後の違い(差分)が行ごとに表示されます。レビューする人は、差分を読み、気になる行にコメントを付けられます。変更した本人は、指摘を受けて追加のコミットを積み、再び確認を依頼します。この往復がそのまま履歴に残るので、判断の理由をあとから追えます。
GitHubの使い方の実践ステップ
- GitHub のアカウントを作成する。認証を強化するため、二要素認証の設定を行う。
- 練習用に、新しいリポジトリを作る(最初は非公開が安心)。
- 公式の Hello World に沿って、ブランチ作成からマージまで1周する。
- 手元で作業するなら、Git を導入して、リポジトリを手元にコピー(クローン)する。
- 他人のプロジェクトに参加するなら、READMEや貢献の手引きを読む。
- チームで使う場合は、本流(main など)の保護設定と、レビュー必須のルールを決める。
GitHubの使い方の注意点
- リポジトリの公開範囲(公開、非公開)を、作成時に必ず確認します。公開にすると、誰でも閲覧できます。
- パスワードや APIキーを含むファイルをコミットしないでください。誤って公開した場合は、キーを無効化して、新しいものに交換します。
- 外部のコードやライブラリを使うときは、ライセンスを確認します。
- 個人アカウントと組織のアカウントで、権限の管理が異なります。業務で使う場合は、組織の規程に従ってください。
- 画面や機能名は更新されることがあります。最新の手順は公式ドキュメントを確認してください。
GitHubの使い方でよくあるミス
- 非公開のつもりで、公開リポジトリを作る。
- 本流に直接コミットして、レビューを通さない。
- 大きすぎるプルリクエストで、レビューが進まない。
- Issue を立てず、会話の記録が散らばる。
GitHubの使い方のチェックリスト
- リポジトリの公開範囲は、意図したものか。
- 二要素認証を設定したか。
- 秘密情報が含まれていないか。
- 本流への変更は、プルリクエストを経由しているか。
- 外部コードのライセンスを確認したか。
GitHubの使い方のFAQ(よくある質問)
Q. GitHub は無料で使えますか。
A. 無料のプランがあります。機能の範囲や上限は、プランごとに異なり、変更されることがあるので、公式の料金ページを確認してください。
Q. 英語が苦手でも使えますか。
A. 日本語のドキュメントや、日本語の画面表示があります。ただし、海外のプロジェクトは英語でのやり取りが基本です。
Q. プルリクエストは必ず必要ですか。
A. 1人で使うなら必須ではありません。チームで品質を保つには、レビューの仕組みとして役立ちます。
筆者の見解(GitHubの使い方)
GitHub を使いこなす近道は、機能を覚えるより、小さな変更を提案し、レビューを受けて、取り込む一巡を早く体験することだと考えます。仕組みが分かれば、他の機能も応用できます。私見では、まず非公開のリポジトリで気軽に失敗し、公開範囲と秘密情報の扱いだけは最初から慎重に、というのが良い順序です。
GitHubの使い方の関連項目
出典(一次情報)
本記事は一般的な情報の提供を目的としています。SaaS・ツールの機能・料金・無料枠・仕様は頻繁に更新されるため、最新の内容は各社の公式ページでご確認ください。契約・法務・セキュリティに関する判断は、専門家や社内の担当部門にご相談ください。「筆者の見解」は一つの考え方です。