MATLAB での Git の使用

MATLAB^® で Git™ ソース管理を使用すると、ファイルを管理して他のユーザーと共同作業を行うことができます。Git を使用すると、ファイルの変更を追跡して、後で特定のバージョンを再表示できます。MATLAB の現在のフォルダーブラウザーから、既存のリモートリポジトリのクローン、ローカルリポジトリへのファイルの追加、変更のコミット、リモートリポジトリとの間での変更のプッシュとプルを実行できます。

リモート Git リポジトリをクローンした後のリモートリポジトリの操作の基本的なワークフローは次のとおりです。

リモートリポジトリから最新の変更をプルします。
作業フォルダーの既存のファイルを編集します。
新しいファイルをローカルリポジトリに追加するようにマークします。
変更を確認します。
変更済みファイルをローカルリポジトリにコミットします。
変更をリモートリポジトリにプッシュします。

Basic Git workflow

あるいは、ファイルに対する変更を他のユーザーと共有せずに追跡するには、リモートリポジトリと同期しないローカル Git リポジトリを作成できます。リモートリポジトリと同期しないローカルリポジトリを操作する場合も、プルとプッシュのアクションが適用されないことを除き、基本的なワークフローは同じです。

メモ

MATLAB で Git を使用する前に、システムを設定してファイルの破損を避けるために、Git ソース管理の設定で説明している手順に従ってください。

リモート Git リポジトリのクローン

HTTPS または SSH を使用して、(GitHub^® や GitLab^® などから) リモート Git リポジトリのクローンを作成できます。

リモート Git リポジトリをクローンするには、次を行います。

現在のフォルダーブラウザーで、空白部分を右クリックし、[ソース管理] 、 [ファイルの管理] を選択します。MATLAB で [ソース管理を使用したファイルの管理] ダイアログボックスが開きます。
[ソース管理統合] オプションを [Git] に設定します。
[リポジトリのパス] フィールドの横にある [変更] ボタンをクリックします。MATLAB で [リポジトリの選択] ダイアログボックスが開きます。
リモートリポジトリのパスを入力します。
[検証] ボタンをクリックしてリモートリポジトリのパスを確認します。指示に従って、リモートリポジトリのログイン情報 (GitHub のユーザー名と個人用アクセストークンなど) を入力します。パスが有効であれば、[OK] をクリックします。リモートリポジトリが選択され、[ソース管理を使用したファイルの管理] ダイアログボックスに戻ります。
[サンドボックス] フィールドに、取得したファイルを格納する作業フォルダーのパスを入力します。指定したフォルダーは空でなければなりません。
[取得] ボタンをクリックします。指示に従って、リモートリポジトリのログイン情報を入力します。

リモートリポジトリをクローンした後にリモートリポジトリのパスを変更するには、作業フォルダーで右クリックして [ソース管理] 、 [リモート] を選択し、新しいパスを指定します。

HTTPS を使用してリモートリポジトリとやり取りする際にログインプロンプトが頻繁に表示されないようにするには、資格情報を記憶するように Git 資格情報マネージャーを設定します。詳細については、Git 資格情報ヘルパーのインストールを参照してください。あるいは、代わりに SSH を使用して新しい公開鍵を追加し、リモートリポジトリのクローンを作成できます。詳細については、Git SSH 認証を使用するための MATLAB の設定を参照してください。

リモートリポジトリを新しいプロジェクトにクローンすることもできます。詳細については、新しいプロジェクトへのリモート Git リポジトリのクローンを参照してください。

追加するファイルのマーク

作業フォルダーのファイルをソース管理に追加するには、それらを追加するようにマークします。ソース管理に追加されていないファイルは、MATLAB の現在のフォルダーブラウザーの [Git] 列で [ソース管理対象ではありません] アイコン () を使用して示されます。

ファイルを追加するようにマークするには、現在のフォルダーブラウザーでファイルを右クリックし、[ソース管理] 、 [Git に追加] を選択します。追加するようにマークされたファイルは、MATLAB で [追加されました] アイコン () を使用して示されます。

Current Folder browser showing two files. The Git column displays the Not Under Source Control icon next to the first file and the Added icon next to the second file.

変更の確認

作業フォルダーのファイルに変更を加えると、変更されたファイルが MATLAB の現在のフォルダーブラウザーの [Git] 列で [変更されました] アイコン () を使用して示されます。[変更されていません] アイコン () はファイルに変更がないことを示します。

Current Folder browser showing two files. The Git column displays the Modified icon next to the first file and the Unmodified icon next to the second file.

変更済みファイルをコミットする前に、次の表に示すいずれかの方法を使用してファイルに対する変更を確認します。

アクション	手順
変更したファイルをローカルリポジトリにある最新バージョンのファイルと比較する。	現在のフォルダーブラウザーでファイルを右クリックし、[ソース管理] 、 [先祖と比較] を選択します。比較ツールに相違点が表示されます。
変更したファイルをローカルリポジトリにあるいずれかのリビジョンのファイルと比較する。	現在のフォルダーブラウザーでファイルを右クリックし、[ソース管理] 、 [リビジョンと比較] を選択します。次に、変更済みファイルと比較するリビジョンを選択し、[ローカルと比較] ボタンをクリックします。比較ツールに相違点が表示されます。
ローカルリポジトリにある以前の 2 つのリビジョンのファイルを比較する。	現在のフォルダーブラウザーでファイルを右クリックし、[ソース管理] 、 [リビジョンと比較] を選択します。次に、比較する 2 つのリビジョンを選択し、[選択対象の比較] ボタンをクリックします。比較ツールに相違点が表示されます。
ローカルリポジトリにあるファイルのリビジョンを参照する。	現在のフォルダーブラウザーでファイルを右クリックし、[ソース管理] 、 [リビジョンの表示] を選択します。過去に誰が、いつファイルをコミットしたか、ログメッセージ、および各変更セット内のファイルのリストを確認できます。複数のファイルを選択し、各ファイルのリビジョン履歴を確認できます。

変更済みファイルのコミット

作業フォルダーにある新しいファイルと変更済みファイルの現在の状態を記録および保存するには、それらをローカルリポジトリにコミットします。

ファイルをローカルリポジトリにコミットするには、次を行います。

現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [変更の表示とコミット] を選択します。[変更の表示とコミット] ダイアログボックスが開きます。
コミットするファイルを選択します。
[コメント] セクションにコメントを入力します。
[コミット] ボタンをクリックします。

リモートリポジトリの方が進んでいる場合、ファイルのリビジョンを更新するように求められます。リビジョンを更新するには、現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [プル] を選択します。コミットする前に競合を解決します。

ファイルのプッシュ

ローカルリポジトリのコミットされた変更がリモートリポジトリに反映されていない場合、それらの変更をリモートリポジトリにプッシュできます。リモートリポジトリに反映されていない変更がローカルリポジトリにあるかどうかを確認するには、現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [詳細の表示] を選択します。[Git 情報] フィールドに、コミットしたローカルの変更がリモートリポジトリよりも進んでいるか、遅れているか、または一致しているかが示されます。

ローカルリポジトリの方がリモートリポジトリよりも進んでいる場合に変更をプッシュするには、現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [プッシュ] を選択します。リポジトリが更新されたために変更を直接プッシュできない場合は、メッセージが表示されます。続行するには、リモートリポジトリからローカルリポジトリに最新の変更をプルします。

Git のリモートリポジトリでは空のフォルダーはサポートされません。そのため、MATLAB で空のフォルダーを作成してリモートリポジトリに変更をプッシュしている場合、そのリモートリポジトリを新しいローカルリポジトリにクローンするときに空のフォルダーは含まれません。空のフォルダーをリモートリポジトリにプッシュして他のユーザーが使用できるようにするには、このフォルダーに空の gitignore ファイルを作成してから変更をプッシュします。

ファイルのプル

リモートリポジトリの方が進んでいてローカルリポジトリが遅れている場合、最新の変更をローカルリポジトリにプルできます。最新の変更をプルするには、現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [プル] を選択します。競合があると、プルが失敗する場合があります。複雑な変更の場合は、オリジナル (ローカルリポジトリ) からブランチを作成し、いくつか変更を加えてから、そのブランチをメインのトラッキングブランチにマージすることを検討してください。

プルアクションは、最新の変更をフェッチし、現在のブランチにそれらをマージします。リポジトリから入ってくる内容が不明な場合は、まずファイルをフェッチして変更を確認してから、変更を手動でマージします。

ファイルのフェッチ

リモートリポジトリから最新の変更をフェッチするには、現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [フェッチ] を選択します。フェッチにより、元のブランチがすべて更新されてローカルリポジトリに反映されます。作業フォルダーのファイルは変更されません。リモートリポジトリからの変更を確認するには、元の変更をローカルブランチにマージする必要があります。

マージする必要があるフェッチされた変更がローカルリポジトリにあるかどうかを確認するには、現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [詳細の表示] を選択します。[Git 情報] フィールドに、コミットしたローカルの変更がリモートリポジトリよりも進んでいるか、遅れているか、または一致しているかが示されます。コミットしたローカルの変更が遅れている場合、リモートリポジトリから最新の変更をフェッチしてマージする必要があります。

たとえば、メインブランチで操作している場合に、リモートリポジトリのメインブランチからすべての変更を取得するとします。

現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [フェッチ] を選択します。
現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [ブランチ] を選択します。
[ブランチ] ダイアログボックスの [ブランチ] リストで [origin/main] を選択します。
[マージ] をクリックします。元のブランチの変更が作業フォルダーのメインブランチにマージされます。

マージが成功したかどうかを確認するには、現在のフォルダーブラウザーで右クリックし、[ソース管理] 、 [詳細の表示] を選択します。[Git 情報] フィールドに Coincident with /origin/main と示されていれば、変更が正常にマージされており、リモートリポジトリからフェッチして作業フォルダーにマージした変更を確認できます。

競合の解決

自分と別のユーザーが別々の作業フォルダーまたは別々のブランチに含まれている同じファイルに変更を加えた場合、変更済みファイルをコミットしようとすると、競合に関するメッセージが表示されます。競合を解決するには、競合の原因となっている相違点を比較し、競合する変更をマージまたは上書きします。競合を解決したら、解決済みとしてマークし、ファイルをコミットできます。

競合は、MATLAB の現在のフォルダーブラウザーの [Git] 列において赤い警告アイコン () で示されます。ファイルの競合を解決するには、次を行います。

競合のあるファイルを右クリックし、[ソース管理] 、 [競合を表示] を選択します。比較ツールが開き、競合する 2 つのリビジョンのファイルの相違点が表示されます。
比較ツールを使用して、競合の解決方法を決定します。2 つのリビジョン間の変更をマージするには、ファイルやフォルダーの比較とファイルのマージを参照してください。
競合を解決したら、現在のフォルダーブラウザーでファイルを右クリックし、[ソース管理] 、 [競合が解決済みであるとしてマークする] を選択します。
変更済みファイルをコミットします。

競合マーカーの抽出

バイナリとして登録されていないファイル (テキストファイルなど) で作業している場合、それらのファイルに Git によって競合マーカーが挿入されることがあります。競合マーカーは次の形式で表されます。

<<<<<<<["mine" file descriptor]
["mine" file content]
=======
["theirs" file content]
<<<<<<<["theirs" file descriptor]

競合を解決する前に、MATLAB を使用してファイルから競合マーカーを抽出できます。

競合のあるファイルを開くか [競合を表示] を選択すると、MATLAB でファイルの競合マーカーが確認されます。ファイルに競合マーカーが含まれている場合、[競合マーカーが見つかりました] ダイアログボックスが開きます。指示に従って、競合マーカーを抽出してファイルを修正します。

競合マーカーを表示するには、[競合マーカーが見つかりました] ダイアログボックスで、[ファイルの読み込み] をクリックします。MATLAB では競合マーカーは認識されないため、ファイルは開かないでください。代わりに、[ファイルの修正] をクリックして、競合マーカーを抽出します。

競合がないファイルに競合マーカーが残っていることがあります。この状況は、競合があるファイルを解決済みとしてマークし、ローカルリポジトリにコミットした場合に発生する可能性があります。競合があるとマークされていないファイルに競合マーカーが確認された場合、手動で競合マーカーを抽出できます。

現在のフォルダーブラウザーで、ファイルを右クリックし、[ソース管理] 、 [競合マーカーをファイルに抽出] を選択します。
[競合マーカーをファイルに抽出] ダイアログボックスで、競合のあるファイルに "自分" のファイルバージョンをコピーする既定のオプションと [抽出されたファイルを比較します] オプションが選択されていることを確認します。
[抽出] をクリックします。
比較ツールを使用して競合を解決します。

ファイルの管理

ローカル Git リポジトリのファイルを管理するために、現在のフォルダーブラウザーからさまざまなアクションを実行できます。ファイルのソース管理ステータスを更新したり、移動、名前の変更、削除、元に戻すなどのファイルの操作を実行できます。

次の表に、ファイルを管理するために実行できるアクションを示します。

アクション	手順
1 つ以上のファイルのソース管理ステータスを更新する	現在のフォルダーブラウザーで、1 つ以上のファイルを選択し、右クリックして [ソース管理] 、 [Git 状態を更新] を選択します。
ローカルリポジトリにあるすべてのファイルのソース管理ステータスを更新する	現在のフォルダーブラウザーで、空白部分を右クリックし、[ソース管理] 、 [Git 状態を更新] を選択します。
ファイルを移動する	現在のフォルダーブラウザーで、ファイルを右クリックして [ソース管理] 、 [移動] を選択し、新しいファイルの場所を入力します。
ファイルの名前を変更する	現在のフォルダーブラウザーで、ファイルを右クリックして [ソース管理] 、 [名前の変更] を選択し、新しいファイル名を入力します。
ファイルをローカルリポジトリから削除し、作業フォルダーにコピーを残しておく	現在のフォルダーブラウザーで、ファイルを右クリックし、[ソース管理] 、 [Git から削除] を選択します。ファイルがソース管理からの削除対象としてマークされると、その記号が [削除されました] () に変わります。ファイルは、次のコミット時に、リポジトリから削除されます。
ファイルをローカルリポジトリと作業フォルダーから削除する	現在のフォルダーブラウザーで、ファイルを右クリックし、[ソース管理] 、 [Git とディスクから削除] を選択します。ファイルは現在のフォルダーブラウザーから消え、即座に作業フォルダーから削除されます。ファイルは、次のコミット時に、リポジトリから削除されます。
ローカルリポジトリにあるファイルの変更を元に戻す	現在のフォルダーブラウザーで、ファイルを右クリックし、[ソース管理] 、 [ローカルな変更を元に戻す] を選択します。
ローカルリポジトリにあるすべてのファイルのローカルな変更を元に戻す	現在のフォルダーブラウザーで、空白部分を右クリックし、[ソース管理] 、 [ブランチ] を選択します。[ブランチ] ダイアログボックスで [HEAD に戻す] をクリックします。
ファイルを指定したリビジョンに戻す	現在のフォルダーブラウザーで、ファイルを右クリックし、[Git を使用して元に戻す] を選択します。次に、リビジョンを選択し、[元に戻す] ボタンをクリックします。ファイルを以前のリビジョンに戻した後に、変更を加えた場合、リポジトリ履歴との競合が解決するまで、ファイルをコミットできません。

ローカル Git リポジトリの作成

ファイルに対するバージョン管理を他のユーザーと共有せずに追加する場合は、リモートリポジトリにリンクせずにシステムでローカル Git リポジトリと作業フォルダーを作成できます。

ローカル Git リポジトリと作業フォルダーを作成するには、次を行います。

現在のフォルダーブラウザーで、空白部分を右クリックし、[ソース管理] 、 [ファイルの管理] を選択します。MATLAB で [ソース管理を使用したファイルの管理] ダイアログボックスが開きます。
[ソース管理統合] オプションを [Git] に設定します。
[リポジトリのパス] フィールドの横にある [変更] ボタンをクリックします。MATLAB で [リポジトリの選択] ダイアログボックスが開きます。
[ディスク上に Git リポジトリを作成] ボタンをクリックします。
ローカルリポジトリを作成して格納するフォルダーを選択し、[フォルダーの選択] をクリックします。選択したフォルダーは空でなければなりません。
[検証] ボタンをクリックしてリポジトリのパスを検証します。パスが有効であれば、[OK] ボタンをクリックします。[ソース管理を使用したファイルの管理] ダイアログボックスに戻ります。
[サンドボックス] フィールドに、ファイルを格納する作業フォルダーのパスを入力します。指定したフォルダーは空でなければなりません。
[取得] ボタンをクリックします。

ローカルリポジトリと作業フォルダーを作成した後にローカルリポジトリのパスを変更するには、作業フォルダーで右クリックして [ソース管理] 、 [リモート] を選択し、新しいパスを指定します。

ローカルシステムのリポジトリで Git サーバーを使用するには、Git サーバーホスティングソリューションを使用するか、独自の Apache^® Git サーバーを設定できます。

メモ

実稼働環境では、file:/// protocol を使用してファイルシステム経由でリモートリポジトリに依存することは避けてください。このファイルプロトコルは安全ではありません。同時アクセスによって、リポジトリが破損する可能性があります。

コミットされていない変更の Git 一時退避を使用した保存

変更済みファイルを後で使用するためにコミットせずに保存するには、Git 一時退避を作成します。一時退避を使用すると、ファイルに対する変更を新しいブランチに簡単に移動することもできます。

一時退避を作成するには、現在のフォルダーブラウザーで、作業フォルダー内の空白部分を右クリックして [ソース管理] 、 [一時退避] を選択します。次に、[新規一時退避] ボタンをクリックします。

一時退避に含まれる変更済みファイルを表示するには、現在のフォルダーブラウザーで、空白部分を右クリックして [ソース管理] 、 [一時退避] を選択します。[使用可能な一時退避] セクションで一時退避を選択し、変更済みファイルを右クリックして変更を表示したりコピーを保存したりできます。

一時退避を現在のブランチに適用してから一時退避を削除するには、[ポップ] をクリックします。一時退避を適用して維持するには、[適用] をクリックします。

一時退避を削除するには、[削除] をクリックします。