/usr/share/doc/git

Git & GitHub 完全ガイド

CHAPTERS
75
WRITTEN
20
PARTS
11
PROGRESS
27%
START → 01 はじめに ── このガイドの読み方

Git と GitHub を、はじめて触る人でも基礎から順に学べる日本語ガイドです。全75ページ・11部構成。

Git(ギット)は、ファイルの変更履歴を自分のPCに記録するソフトです。GitHub(ギットハブ)は、その履歴をインターネット上に預けて、人と共有するためのサービスです。名前は似ていますが、別のものです。このガイドは、この2つを混ぜずに、Git を先に、GitHub を後に扱います。

「なんとなく push はしている」という人にも、内部の仕組みからチームでの運用まで、入門で終わらない内容を用意しています。

読み始める前に#

はじめての人は、第1部の01(はじめに ── このガイドの読み方)から順に読んでください。全体の地図と、目的別にどこから読み始めればよいかを示しています。

困ったことが起きて調べに来た人は、第11部の73(困ったときの逆引き集)へ直行してください。

Git編(第1部〜第5部・35ページ)#

Git の仕組みと使い方です。第2部から第5部は自分のPCの中だけで完結し、インターネット接続は必要ありません。

GitHub編(第6部〜第11部・40ページ)#

手元の Git の履歴を GitHub に預け、人と一緒に使う話です。

PART 01導入 ── 全体像をつかむ

Git と GitHub の違いを押さえ、アカウントを用意します。ここは全員が読む部です。

  1. 01はじめに ── このガイドの読み方
  2. 02バージョン管理とは何か
  3. 03GitとGitHubの違い
  4. 04GitHubアカウントを作る
  5. 05最低限おぼえる10の用語

PART 03Gitの内部構造 ── なぜそう動くのか

コマンドの結果を、暗記ではなく仕組みで説明できるようになります。初読は流し読みで構いません。

  1. 16Gitは差分ではなくスナップショットを保存する
  2. 174つのオブジェクト(blob / tree / commit / tag)
  3. 18HEAD とは何か・detached HEAD
  4. 19参照(refs)とブランチの実体
  5. 20.git フォルダの中身ツアー

PART 04ブランチとマージ

作業を分岐させ、安全に統合できるようになります。

  1. 21ブランチとは何か執筆中
  2. 22ブランチを作る・切り替える・消す執筆中
  3. 23マージの仕組み(Fast-forward と3-way)執筆中
  4. 24コンフリクトを解決する執筆中
  5. 25rebase を理解する執筆中
  6. 26interactive rebase で履歴を整える執筆中
  7. 27cherry-pick で特定のコミットだけ運ぶ執筆中
  8. 28ブランチ戦略(GitHub Flow / Git Flow / trunk-based)執筆中

PART 05Gitの実務テクニック

stash・bisect・hooks など、現場で使う道具をそろえます。

  1. 29stash ── 作業を一時退避する執筆中
  2. 30tag ── バージョンに印を付ける執筆中
  3. 31blame と検索(grep / log -S)執筆中
  4. 32bisect ── バグ混入コミットを二分探索する執筆中
  5. 33worktree ── 複数ブランチを同時に開く執筆中
  6. 34submodule と subtree執筆中
  7. 35hooks ── 操作の前後に処理を挟む執筆中

PART 06GitHubと繋ぐ

手元の履歴をクラウドに上げ、取得できるようになります。ここで初めてインターネットが登場します。

  1. 36リモートリポジトリという考え方執筆中
  2. 37認証を通す(HTTPS+PAT / SSH)執筆中
  3. 38GitHubにリポジトリを作る執筆中
  4. 39push でアップロードする執筆中
  5. 40clone・fetch・pull でダウンロードする執筆中
  6. 41追跡ブランチ(upstream)を理解する執筆中
  7. 42既存プロジェクトをGitHubに載せる執筆中

PART 07GitHubで共同開発する

Issue と Pull Request を使って、人と一緒に開発できるようになります。

  1. 43Issue ── 作業を可視化する執筆中
  2. 44ラベル・マイルストーン・テンプレート執筆中
  3. 45Pull Request の作り方執筆中
  4. 46コードレビューの実践執筆中
  5. 47ブランチ保護とマージ方式執筆中
  6. 48Fork してOSSに貢献する執筆中
  7. 49Organization とチーム権限執筆中
  8. 50Projects で進捗を管理する執筆中
  9. 51CODEOWNERS・Discussions・Wiki執筆中

PART 08GitHubの機能を使い倒す

README・ライセンス・Pages など、リポジトリの周辺機能を使いこなします。

  1. 52README を書く執筆中
  2. 53GitHub Markdown記法とGist執筆中
  3. 54ライセンスを選ぶ執筆中
  4. 55Release とタグでバージョンを配る執筆中
  5. 56GitHub Pages で公開する執筆中
  6. 57セキュリティ機能(Dependabot / Secret scanning / CodeQL)執筆中
  7. 58検索・Star・Watch・Insights執筆中

PART 09GitHub Actions ── 自動化

テストや公開を自動化します。

  1. 59CI/CDとGitHub Actionsの基本執筆中
  2. 60ワークフローYAMLの書き方執筆中
  3. 61Secrets と変数の扱い執筆中
  4. 62実践レシピ集執筆中
  5. 63Marketplace と再利用可能ワークフロー執筆中
  6. 64料金と実行時間の考え方執筆中

PART 10ツールで楽をする

GUI や CLI のツールで、日常の作業を速くします。

  1. 65VS Code の Git 機能執筆中
  2. 66GitHub Desktop執筆中
  3. 67GitHub CLI(gh)執筆中
  4. 68環境をカスタマイズする(config / alias / diffツール)執筆中
  5. 69AIとの連携(Copilot / Claude Code)執筆中

PART 11実践と逆引き

実際のワークフローを組み立て、トラブルから自力で復旧できるようになります。

  1. 70ケース①:個人開発のワークフロー執筆中
  2. 71ケース②:少人数チームのワークフロー執筆中
  3. 72ケース③:非エンジニアの文書・設定管理執筆中
  4. 73困ったときの逆引き集執筆中
  5. 74コマンドチートシート執筆中
  6. 75この先の学び方執筆中