プログラミング初心者

初心者のためのGitHub入門:プログラミングの学習ログを残そう

ながみえ

GitHubは、作成したプログラムや学習メモをオンラインで保存し、変更履歴を残せるサービスです。プログラミング学習に使えば、「いつ、何を学び、どのようなコードを書いたか」を一つの場所で管理できます。

この記事では、GitHubの無料アカウントを用意し、学習記録を保存するためのリポジトリを作成するところから、READMEの編集、最初のファイルの保存までを初心者向けに説明します。最初は難しいGitコマンドを使わず、ブラウザだけで進められます。

使用している教材やプログラミング言語は問いません。Python、JavaScript、HTML/CSSなど、学習中のコードやメモを残したい方が同じ手順を利用できます。

このサイトの教材でPythonを勉強している場合は、【完全無料】Python初心者向け完全ガイドの練習問題とLesson番号に合わせてファイルを整理することもできます。記事内では、その構成例も紹介します。

この記事のゴールは、GitHubのすべての機能を覚えることではありません。自分用の学習リポジトリを一つ作り、今日書いたコードや学んだことを保存できる状態にすることです。

あわせて読みたい
Python入門講座|初心者向け無料カリキュラム
Python入門講座|初心者向け無料カリキュラム

GitHubとは何か|概要とGitとの違い

GitHub(ギットハブ)は、プログラムのコードやメモなどのファイルをオンラインで保存・管理できるサービスです。

一般的なオンラインストレージとの大きな違いは、ファイルを更新した記録を「コミット」という単位で残せることです。いつ、どのような変更をしたのかを後から確認できるため、以前の内容と見比べながら学習を進められます。

プログラミング学習では、主に次のような使い方ができます。

  • 練習問題で作成したコードを保存する
  • READMEに学習目的や進み具合を書く
  • コードを修正した履歴を残す
  • 過去に書いたコードを見直す

ここで、GitとGitHubの違いも簡単に確認しておきましょう。

Gitは、ファイルの変更履歴を管理するための仕組みです。一方のGitHubは、Gitで管理するファイルや変更履歴をオンライン上で保存・共有しやすくしたサービスです。

本格的な開発ではパソコンにGitをインストールしてコマンドを使いますが、学習記録を始めるだけなら、最初はGitHubのWeb画面からファイルを作成・編集できます。

リポジトリの公開範囲は、誰でも閲覧できるPublicと、自分や許可した人だけが閲覧できるPrivateから選べます。詳しい選び方は、後の「リポジトリは公開しないといけないのか」で説明します。

まずは、コードや学習メモを入れるための「リポジトリ」を一つ作るところから始めましょう。

GitHubの使い方|アカウントと学習用リポジトリの作成

ここからは、GitHubの無料アカウントを用意し、コードや学習メモを保存するためのリポジトリを作成します。

特定の教材やプログラミング言語に限定しない手順なので、Python、JavaScript、HTML/CSSなどの学習に利用できます。

GitHubの無料アカウントを作る

すでにGitHubアカウントを持っている場合は、次の「学習用リポジトリを作る」へ進んでください。

  1. GitHub公式サイトを開く
  2. 画面の「Sign up」を選択する
  3. メールアドレス、パスワード、ユーザー名などを画面に従って設定する
  4. GitHubから届くメールを確認し、メールアドレスの認証を完了する
  5. 作成したアカウントでGitHubへログインする

画面に表示されている場合は、GoogleまたはAppleのアカウントを使って登録することもできます。

ユーザー名はリポジトリのURLやプロフィールに表示されます。本名を使う必要はありませんが、後から見ても分かりやすい名前にしましょう。

また、アカウントを安全に利用するため、登録後は2要素認証の設定も推奨します。

学習用リポジトリを作る

リポジトリとは、コードやメモをまとめて保存するための入れ物です。今回は、自分の学習記録を保存するリポジトリを一つ作ります。

  1. GitHubへログインする
  2. 画面右上の「+」メニューを開く
  3. 「New repository」を選択する
  4. 「Repository name」にリポジトリ名を入力する
  5. 必要に応じて「Description」に説明を入力する
  6. 公開範囲として「Public」または「Private」を選択する
  7. 「Add README」をオンにする
  8. 「Create repository」を選択する

リポジトリ名には、次のような短く分かりやすい名前を使用できます。

  • learning-log
  • programming-practice
  • python-learning-log

公開範囲を迷う場合は、最初はPrivateを選んでも構いません。PublicとPrivateの違いや注意点は、後の章で詳しく説明します。

作成後、リポジトリのトップページにREADME.mdが表示されていれば、リポジトリの準備は完了です。

READMEに学習内容を書く

READMEは、リポジトリの目的や保存している内容を説明するファイルです。リポジトリを開いたときに内容が表示されるため、最初に簡単な説明を書いておきましょう。

  1. リポジトリ内のREADME.mdを開く
  2. 鉛筆マークの編集ボタンを選択する
  3. 次のテンプレートを参考に内容を入力する
  4. 「Commit changes」を選択する
  5. 変更内容を表す短いメッセージを入力して保存する
# プログラミング学習記録

このリポジトリには、プログラミング学習で作成したコードとメモを保存します。

## 使用教材

- 教材名:
- URL:

## 保存する内容

- 練習問題の解答コード
- 学習中に気づいたこと
- エラーと解決方法

## 現在の学習内容

- 学習中の言語:
- 取り組んでいる内容:

このサイトの教材を使用している場合は、「使用教材」にPython関連学習館の教材名とURLを記入できます。それ以外の教材を使っている場合も、同じ形式で記録できます。

最初のコミットメッセージは、READMEに学習目的を追加のように、何を変更したのか分かる内容にしましょう。

最初の学習ファイルを作る

続いて、リポジトリに最初のファイルを作成します。

  1. リポジトリのトップページで「Add file」を選択する
  2. 「Create new file」を選択する
  3. ファイル名を入力する
  4. 学習したコードやメモを入力する
  5. 「Commit changes」を選択して保存する

Pythonの練習コードなら、ファイル名は次のようにできます。

practice/lesson-01.py

ファイルの内容には、実際に試したコードを入力します。

print("Hello, GitHub!")

メモを保存したい場合は、次のようなMarkdownファイルを作成できます。

notes/day-01.md

ファイルを空のまま保存するのではなく、コメントや短いメモを一行以上入力してから保存してください。

これで、GitHubアカウントの準備、学習用リポジトリの作成、READMEの編集、最初のファイルの保存まで完了です。

GitHubの基本用語|最初に覚える5つだけ

GitHubの画面には、初めて見る用語がいくつか表示されます。ただし、最初からすべての用語を覚える必要はありません。

ここでは、前の章でリポジトリやファイルを作成したときに登場した、5つの基本用語だけを確認します。

用語最初はこう理解すればOK
リポジトリ(Repository)コードやメモ、変更履歴をまとめて保存する場所
README.mdリポジトリの目的や内容を説明する案内ページ
コミット(Commit)ファイルに加えた変更を履歴として記録すること
コミットメッセージどのような変更をしたのかを説明する短い文章
main(メインブランチ)通常の変更履歴が記録される基本の作業場所

特に覚えておきたいのは、コミットです。

一般的なファイル編集では、内容を上書きして保存します。一方、GitHubではコミットすることで、「何を変更したのか」「いつ変更したのか」という履歴を残せます。

コミットするときは、次のように変更内容が分かるメッセージを付けましょう。

READMEに学習目的を追加
練習問題の解答を追加
エラーの修正内容を記録

更新修正だけではなく、何を変更したのかまで書いておくと、後から履歴を見返しやすくなります。

ブランチ、プルリクエスト、Issueなどの機能は、複数人で開発するときや、より本格的にGitHubを使う段階で覚えれば問題ありません。学習記録を始める段階では、リポジトリにファイルを追加し、分かりやすいメッセージでコミットできれば十分です。

GitHubのリポジトリは公開すべき?Public・Privateの選び方

GitHubでリポジトリを作るときは、公開範囲としてPublicまたはPrivateを選択します。

学習記録だからといって、必ず公開する必要はありません。どちらを選ぶか迷う場合は、最初はPrivateで始めても問題ありません。

公開範囲閲覧できる人向いている使い方
Publicインターネット上の誰でも閲覧できる公開してよい練習コードや成果物を見てもらいたい場合
Private自分と、アクセスを許可した人学習途中のコードや個人的なメモを保存したい場合

Publicを選ぶと、リポジトリ内のコード、README、コミット履歴などが第三者から閲覧できる状態になります。

一方、Privateなら一般には公開されません。ただし、Privateであっても、パスワードやAPIキーなどの秘密情報を保存してよいわけではありません。

GitHubに保存してはいけないもの

Public・Privateにかかわらず、次の情報はコミットしないでください。

  • パスワード
  • APIキー
  • アクセストークン
  • 個人の住所や電話番号
  • 学校や会社の機密情報
  • 有料教材や試験問題の無断転載
  • 他人が作成したコードや文章の無断コピー

APIキーなどをローカル環境の.envファイルで管理する場合は、.env.gitignoreへ追加し、GitHubへ送信されないようにします。

ブラウザだけでGitHubを使用している段階では、秘密情報を含むファイル自体を作成・アップロードしないようにしてください。

誤って秘密情報を保存した場合

GitHubでは、ファイルから文字を削除しても、過去のコミット履歴に内容が残る場合があります。

APIキーやパスワードを誤ってコミットした場合は、ファイルを削除するだけで終わらせず、使用しているサービス側でそのキーやパスワードを無効化し、新しいものへ変更してください。

公開範囲は後から変更できる

リポジトリの公開範囲は、作成後に変更できます。

変更する場合は、対象リポジトリの「Settings」を開き、「General」の下部にある「Danger Zone」から「Change repository visibility」を選択します。

ただし、公開範囲の変更は関連機能や公開状態に影響することがあります。確認画面の内容を読んでから実行してください。

最初はPrivateで練習し、公開して問題のないコードや説明が整ってからPublicへ変更する方法でも構いません。最初から公開できる内容だけを保存する場合は、Publicを選んでも問題ありません。

まとめ|GitHubに学習記録を残す準備は完了

この記事では、GitHubの基本的な役割を確認し、学習記録を保存するためのリポジトリを作成しました。

ここまでの操作で、次の準備が完了しています。

  • GitHubアカウントを作成した
  • 学習用リポジトリを作成した
  • READMEにリポジトリの目的を書いた
  • 最初のコードまたはメモを保存した
  • PublicとPrivateの違いを確認した
  • 変更内容をコミットとして記録した

今後は、学習中に作成したコードやメモを同じリポジトリへ追加し、変更内容が分かるコミットメッセージを付けて保存していきましょう。

最初から複雑なフォルダ構成やGitコマンドを覚える必要はありません。まずは一つのリポジトリにファイルを追加し、変更履歴を残せれば十分です。

Python関連学習館の教材を使う場合も、ほかの教材やプログラミング言語を使う場合も、同じ方法で学習記録を管理できます。

まずは、次に学んだ内容を一つ追加し、何を変更したのかが分かるメッセージでコミットしてみてください。

あわせて読みたい
Python入門講座|初心者向け無料カリキュラム
Python入門講座|初心者向け無料カリキュラム
ABOUT ME
ながみえ
ながみえ
記事URLをコピーしました