Git・GitHub

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の使い方の実践ステップ

  1. GitHub のアカウントを作成する。認証を強化するため、二要素認証の設定を行う。
  2. 練習用に、新しいリポジトリを作る(最初は非公開が安心)。
  3. 公式の Hello World に沿って、ブランチ作成からマージまで1周する。
  4. 手元で作業するなら、Git を導入して、リポジトリを手元にコピー(クローン)する。
  5. 他人のプロジェクトに参加するなら、READMEや貢献の手引きを読む。
  6. チームで使う場合は、本流(main など)の保護設定と、レビュー必須のルールを決める。

GitHubの使い方の注意点

  • リポジトリの公開範囲(公開、非公開)を、作成時に必ず確認します。公開にすると、誰でも閲覧できます。
  • パスワードや APIキーを含むファイルをコミットしないでください。誤って公開した場合は、キーを無効化して、新しいものに交換します。
  • 外部のコードやライブラリを使うときは、ライセンスを確認します。
  • 個人アカウントと組織のアカウントで、権限の管理が異なります。業務で使う場合は、組織の規程に従ってください。
  • 画面や機能名は更新されることがあります。最新の手順は公式ドキュメントを確認してください。

GitHubの使い方でよくあるミス

  • 非公開のつもりで、公開リポジトリを作る。
  • 本流に直接コミットして、レビューを通さない。
  • 大きすぎるプルリクエストで、レビューが進まない。
  • Issue を立てず、会話の記録が散らばる。

GitHubの使い方のチェックリスト

  • リポジトリの公開範囲は、意図したものか。
  • 二要素認証を設定したか。
  • 秘密情報が含まれていないか。
  • 本流への変更は、プルリクエストを経由しているか。
  • 外部コードのライセンスを確認したか。

GitHubの使い方のFAQ(よくある質問)

Q. GitHub は無料で使えますか。
A. 無料のプランがあります。機能の範囲や上限は、プランごとに異なり、変更されることがあるので、公式の料金ページを確認してください。

Q. 英語が苦手でも使えますか。
A. 日本語のドキュメントや、日本語の画面表示があります。ただし、海外のプロジェクトは英語でのやり取りが基本です。

Q. プルリクエストは必ず必要ですか。
A. 1人で使うなら必須ではありません。チームで品質を保つには、レビューの仕組みとして役立ちます。

筆者の見解(GitHubの使い方)

GitHub を使いこなす近道は、機能を覚えるより、小さな変更を提案し、レビューを受けて、取り込む一巡を早く体験することだと考えます。仕組みが分かれば、他の機能も応用できます。私見では、まず非公開のリポジトリで気軽に失敗し、公開範囲と秘密情報の扱いだけは最初から慎重に、というのが良い順序です。

GitHubの使い方の関連項目

出典(一次情報)

本記事は一般的な情報の提供を目的としています。SaaS・ツールの機能・料金・無料枠・仕様は頻繁に更新されるため、最新の内容は各社の公式ページでご確認ください。契約・法務・セキュリティに関する判断は、専門家や社内の担当部門にご相談ください。「筆者の見解」は一つの考え方です。