投稿

gitの使い方とか

gitの使い方とか

まずgitとは?

Git(ギット[2][3][4][5])は、プログラムのソースコードなどの変更履歴を記録・追跡するための分散型バージョン管理システムである。Linuxカーネルのソースコード管理に用いるためにリーナス・トーバルズによって開発され、それ以降ほかの多くのプロジェクトで採用されている。Linuxカーネルのような巨大プロジェクトにも対応できるように、動作速度に重点が置かれている。現在のメンテナは濱野純 (英語: Junio C Hamano) で、2005年7月から担当している。

Gitでは、各ユーザのワーキングディレクトリに、全履歴を含んだリポジトリの完全な複製が作られる。したがって、ネットワークにアクセスできないなどの理由で中心リポジトリにアクセスできない環境でも、履歴の調査や変更の記録といったほとんどの作業を行うことができる。これが「分散型」と呼ばれる理由である。

2025年、SCM市場で87%のシェアを占めている[6]wikipediaより

バージョン管理システム(Version Control System; eg.vcs)の1つです。 いつ誰がどのファイルをどの場所でどういう目的で作成・変更・削除したかの履歴を残すことができます。 削除したファイルの復元もできます。

複数人で利用するときに最も威力を発揮しますが、個人で利用しても便利なソフトウェアです。

run.pyというファイルを編集しているとします。

1
2
3
4
5
6
7
8
9
10
total 28
drwxr-xr-x  2 kinoko kinoko 4096 Mar  5 22:05  ./
drwxr-xr-x 25 kinoko kinoko 4096 Mar  5 21:57  ../
-rw-r--r--  1 kinoko kinoko  352 Mar  1 21:58  run_copy.py
-rw-r--r--  1 kinoko kinoko  383 Feb 28 21:58  run_koh.py
-rw-r--r--  1 kinoko kinoko  330 Mar  1 21:59  run_latest.py
-rw-r--r--  1 kinoko kinoko  341 Feb 22 09:58  run.py
-rw-r--r--  1 kinoko kinoko  351 Mar  2 22:04  run_最新版.py
-rw-r--r--  1 kinoko kinoko  347 Mar  5 21:35 'run_最新版 - コピー(2).py'
-rw-r--r--  1 kinoko kinoko  319 Mar  5 22:04 'run_最新版 - コピー.py'

どれが本当の最新版でしょうか。

複数人で作業している場合や人に見せないといけない場合は

  • どれが本当の最新版かわからない
  • コードのどの部分を誰が変更したのかわからない
  • 他の人の修正箇所を上書きしてなかったことにしてしまう

これらの問題を解決するためのソフトウェアがGitです。(あるいはvcsとよばれるソフトウェア群)

0. 準備

github.comでアカウントを作成してください。既にアカウントを持っている場合はしなくて大丈夫です。

1. インストール

git-scm.comからダウンロードしてインストール。 インストールはデフォルトの状態でNext連打で大丈夫です。

wingetを使用する場合はターミナルで

1
winget install Git.Git

と入力します。

MacでHome brewを使用する場合はターミナルで

1
brew install git

と入力します。

GNU/Linuxを使用している場合はそのOSのパッケージマネージャーを使用してください。 参考: git-scm.com/install/linux

動作確認

ターミナルを開いて

1
git --version

と入力して、正常にインストールされているか確認します。

期待される出力の例

1
2
$ git --version
git version 2.53.0

設定

Gitにユーザー名とメールアドレスを登録します。 Githubにpushしたときに全世界に公開されるので、公開されても構わないユーザー名とメールアドレスに設定します。

1
2
3
4
5
6
git config --global user.name "ユーザー名"
git config --global user.email "メールアドレス"

# example
git config --global user.name "koh11235813"
git config --global user.email "gh@kinoko1943.org"

公開されても問題ないメールアドレスを持っていない場合は github.com/settings/emails を開き

Keep my email addresses private

画像の場所を見つけてKeep my email addresses private にチェックを入れ、ここに表示されているメールアドレスを設定します。画像の場合だと、77713907+koh11235813@users.noreply.github.comとなります。

2. 基本操作

Gitがバージョン管理下に置く場所をリポジトリ(repository)と呼びます。

ユーザーが変更の履歴を記録する作業をコミット(commit)と呼びます。

コミットには前回との差分が保存されています。コミットには必ずコミットメッセージというコメントをつける必要があります。

commit

基本的には コードを書く→コミットをする を繰り返します。

実際に作業中のファイル群をワーキングツリーと呼びます。 リポジトリにコミットしたいファイルは、まずステージ(Stage)に移動させなければなりません。作業中のディレクトリからステージに移動することを「ステージング」と呼び、git add <ステージに移動したいファイル> で移動できます。

working tree

つまりコミットを行なうと、ステージ領域に入っているファイルの変更履歴が残されます。変更履歴を残したくないファイルはステージに移動させなければ良いのです。

リポジトリの作成

任意の場所に新しいディレクトリを作成します。 ターミナル上でmkdirを使用して作成してもいいですし、もちろんエクスプローラーやFinderで作成してもOK。

mkdir git-practice

ターミナルを開いてcdコマンドで作成したディレクトリに移動し、git initを実行。

git init

.gitという隠しディレクトリが生成されます。

これでローカルリポジトリの作成完了です。

コミット

.gitと同じ階層にテキストファイルを作成します。

ここでは、hoge.txtを作成します。hoge.txtには任意のなにかを書き込みます。(例: Hello Git!, hogehoge fugafuga)

git statusを実行して、現在の状態を確認します。

1
$ git status

git status unstaged

On branch main 現在のブランチがmainブランチであることを示しています。

Untracked files 下の赤字のファイルがステージに移動されていないことを示しています。

git add hoge.txtを実行して、hoge.txtをステージに追加

git statusを再度実行して、変化を見てみましょう。

1
$ git status

git status staged

Changes to be committedの下にnew file: hoge.txtを確認できます。 ステージに新しくhoge.txtが登録されています。

git commit -m "コミットメッセージ"を実行して、コミットします。 コミットメッセージではどのような変更をしたかを簡潔に書きます。画像では”initial commit”(初めてのコミット)としています。

コミットしたら、git statusを実行して変化を見てみましょう。また、git logを実行してコミット履歴を表示してみましょう。

git commit -m "initial commit"

git status: nothing to commit, working tree clean コミットするものはなにもない git log: コミットの履歴を表示

コミットを行ったら、hoge.txtを修正してみましょう。

好きな文字列を追加してもらって構いませんが、例ではGit 完全に理解したと追記しています。

追記したら、git statusを確認してみましょう。

git diff

Changes not staged for commit: 変更されたファイルがあり、ステージされていない。 modified: hoge.txt: hoge.txtが変更されている。

git diffでは差分を確認できます。 +Git 完全に理解した: 追加された行。先頭に+が追加、-が削除された行。

再びコミットを行ってみましょう git add <ファイル名>: ステージに移動 git commit -m "コミットメッセージ": コミット git status: 確認 git log: 今までのコミットを表示

git commit -m "add content"

基本は何か作業→add→commit(→push)を繰り返します.

3. ブランチ

ブランチとは、履歴の流れを分岐して記録するためのものです。

あるコミットから枝分かれして、新しくコミットしていきます。

分岐したブランチは他のブランチの影響を受けないため、同じリポジトリ内で複数の変更を同時に進めていくことができます。

branch figure

ブランチの変更を他のブランチに統合することをマージ(merge)といいます。下の図で矢印の先が別のブランチを指しているものはマージを行なっています。

branch merge

ブランチを分ける意味

  • 複数の作業を並列して進めることができます。
  • ブランチ名を予め決めておいたルールに沿って命名することで作業内容がわかりやすくなります。

コンフリクト (Conflict)

マージの際に、同じファイルの同じ場所に両方のブランチで修正が行われていた場合に、コンフリクト(Conflict、衝突)が発生する。

Gitがどちらのブランチの変更箇所が正しいのか判断できないため、作業者が修正する必要がある。

Conflict

コンフリクトを発生させてみましょう!

git branch <ブランチ名>で現在のブランチから新しくブランチを作成します。ここでは、git branch hugaでブランチ「huga」を作成しています。

git checkout <ブランチ名>でブランチを切り替えます。

テキストファイルの内容を変更します。

just a little

add, commitを行います。

git checkout mainでmainブランチへ戻ります。

ちなみに、この時点でhugaブランチをマージするとテキストファイルの内容はhugaブランチの内容になります。

mainブランチで、hugaブランチで変更した場所と同じ場所を変更してみます。画像では、「Gitなにもわからない」に書き換えています。

I dont know

git merge hugaでhugaブランチをマージします。

コンフリクト発生!

マージに失敗したので直してコミットしろと言われます。

テキストファイルにはなにやら追記がされています。

merge

作業者が修正する必要があります。該当部分を修正して、add, commitします。

fix conflict

ログを見ると、hugaブランチのコミットも含まれています。

git log --graph でグラフ表示をしてみましょう。

( git log --graph --oneline でコミットを1行にしてグラフ表示できます。)

枝分かれしてたブランチがmainブランチに統合されているのが確認できます。hugaブランチは消えているわけではないことに注意が必要です。(またhugaブランチで作業して同じようにマージすることもできる)

git log --graph

何がいけなかったか?→ 同じファイルの修正

  • 複数人で作業する時は同じファイルを編集しないようにファイル分割すべき
  • 自分だけ触れてる場所なら修正は楽
  • 複数人かつブランチで作業量が多い(複数のファイルの複数の箇所を同時編集)ほど深刻

4. GitHub

Gitによるバージョン管理する場所をリポジトリと呼びます。

自分1人だけでプログラムを組むならば、リポジトリは自分のPC内だけで問題ありません。しかし、ネットワークを介して別のPCからどこからでも利用したい、または複数人で利用したい場合は、リポジトリをサーバー上に用意する必要があります。

サーバー上にあるリポジトリを「リモートリポジトリ」と呼び、自分のPC内で完結するリポジトリを「ローカルリポジトリ」と呼びます。

remote repository

自前のサーバー上にリモートリポジトリを構築するには知識が要り、サーバー管理も必要です。ありがたいことに、GitHub、Bitbucket, GitLabなどリモートリポジトリを提供するサービスが存在します。

今回はGitHubを使います。

GitHubとは

  • 開発者のためのプラットフォーム
  • 世界中の人々の優れたコードが公開されていて、 コミュニケーションをとれる

利点 issue、PullRequest、Projects等の機能によりチーム開発がしやすい リポジトリを公開してればポートフォリオになる (GitHub選考など) github.ioによる静的サイトの公開が可能

CloneとPushとPull

Clone

git clone <リモートリポジトリ>: リモートリポジトリを複製して新しくローカルリポジトリとして作成できます。新しいマシンで作業する時に使います。

Push

git push: リモートリポジトリにローカルリポジトリの変更履歴をアップロードすることを指します。

Pull

git pull: リモートリポジトリからローカルリポジトリに変更履歴をダウンロードして取り込みます。

リモートリポジトリの作成

new repository

create repository

setup repository

最初のpushまで

先ほどまで使用していたディレクトリで行います。画像の一番下のコマンド(…or push an existing repository from the command line)を順に打ち込んでいきます。

git remote add

途中でユーザー名とパスワードを聞かれていますが、この認証はOSによって異なります。 Windowsの場合はブラウザで認証できるはずです。

アップロードが終わってブラウザをリロードすると以下のようなページになっているはずです。

git remote repository

コマンド解説

git branch -M main: 現在のブランチ名をmainブランチに強制変更

git remote add origin https://github.com/koh11235813/git-practice.git: リモートリポジトリの追加、originという名前でURLの場所がリモートリポジトリとして追加される。

git push -u origin main :

git push origin mainはmainブランチをoriginにpushするコマンド -uオプションは上流ブランチ(upstream)を設定するオプション

リモートにあるブランチのことを上流ブランチ(upstream)と呼ぶ。

ローカルブランチが更新を追いかけるリモートブランチのこと

今回の場合、以降はmainブランチ内で git pushだけでローカルのmainブランチをリモートのmainブランチにpushできるが、本来は git push origin <リモートブランチ名>

git remote -v: 設定されているリモートリポジトリのURLを参照できる。

GitHubを使ってみる

README.md を適当に追加して、add、commitします。

git push origin main

originのmainブランチに現在のブランチをpush

リモートのmainブランチはローカルのmainブランチの上流ブランチなので git pushでも同じ

git push

GitHubのリモートリポジトリに変更が反映されます。

git remote view

README.mdなどのテキストファイルはGitHub上で編集できます。リポジトリのREADME.mdの右上にあるペンマークをクリックして編集します。

readme edit

右上のCommit changes...をクリックするとコミットメッセージを入力できるダイアログが表示されます。

remote commit

このようにWebブラウザ上からでも編集できます。

remote changed

ローカルリポジトリにリモートリポジトリの変更を持って来てみましょう。 git pull origin mainを実行して、originのmainブランチの変更を現在のブランチに反映しましょう。ログを確認すると、GitHub上で変更したリモートリポジトリの内容がローカルリポジトリに取り込まれていることがわかります。(git pushと同じようにgit pullをmainブランチ上で行った場合もgit pull origin mainと同じ意味を持ちます。)

git pull

PullRequest

  • リモートリポジトリのブランチを別のブランチにmergeする要求を送ることができます。
  • 変更箇所、コミット履歴の表示
  • 複数人で開発しているときに、ソースコードに関するコミュニケーションが発生します。
  • コードレビューを必須にし、一定の承認が無いとマージ出来ないような設定にできます。

画像は卒研のリポジトリでGPGPUサポートを行った時のPullRequestです。

pull request

Issue

  • プロジェクトのバグ、機能追加、要望、問題点等について発言する場所
  • issueに基づいてブランチを切ったりする、タスク管理としての運用

issue

Contribution

  • GitHubの機能を使うと、Contributionが増えます。

    masterへのコミット

    Issue、Pull requestの作成

    review?

  • 毎日作業したくなり、モチベになります
  • 日にち毎に合計され、1つでもContributionしていれば緑色になります。

多いほど明るい色

別名「草を生やす」

  • 偽装可能
  • ハロウィンの日だけ色が変わります

contribution

Gitクライアント

コマンドを入力せずにGUI上でGitの操作可能なツール GitGUI、GitHub Desktop、SourceTree、GitKrakenなど

この投稿は投稿者によって CC BY 4.0 の下でライセンスされています。