ファイルの表示と理解

GitHub には、生の内容の表示、特定の行への変更のトレース、ファイルの内容の経時的な進化の探索を行うツールがあります。 これらの分析情報によって、コードが開発された方法、現在の目的、その構造が明らかになり、効果的に貢献するのに役立ちます。

生ファイルの内容を表示またはコピーする

生のビューを使用すると、スタイルを設定せずにファイルの生のコンテンツを表示またはコピーできます。

1. GitHub で、リポジトリのメイン ページに移動します。

2. 表示するファイルをクリックします。

3. ファイル ビューの右上隅にある [未加工] をクリックします。

   

4. 必要に応じて、生ファイルの内容をコピーするには、ファイル ビューの右上隅にある をクリックします。 RAW ファイルをダウンロードするには、[] をクリックします。

ファイルの行ごとのリビジョン履歴の表示

Blame ビュー内では、ファイル全体のリビジョン履歴を 1 行ずつ表示できます。

1. GitHub で、リポジトリのメイン ページに移動します。

2. クリックして、表示したい行の履歴のファイルを開きます。

3. ファイルの内容の上にある [Blame] をクリックしてください。 このビューには、1 行ずつのリビジョン履歴とコミットごとに区切られたファイル内のコードが表示されます。 各コミットには、作成者、コミットの説明、コミット日が一覧表示されます。

4. 特定のコミットの前にあるファイルのバージョンを表示するには、 をクリックします。 または、特定のコミットの詳細を表示するには、コミット メッセージをクリックします。

   

5. 生コード ビューに戻すには、ファイルの内容の上にある [コード] をクリックします。

   • マークダウン ファイルを表示している場合は、ファイルの内容の上にある [プレビュー] をクリックして、Markdown の書式設定が適用されたビューに戻ることもできます。

[変更履歴] ビューのコミットを無視する

リポジトリのルート ディレクトリ内に存在しなければならない、.git-blame-ignore-revs ファイルで指定されたリビジョンはすべて、Git git blame --ignore-revs-file の構成設定を使用して、[変更履歴] ビューに表示されなくなります。 詳細については、Git ドキュメントにある「git blame --ignore-revs-file」を参照してください。

1. リポジトリのルート ディレクトリに .git-blame-ignore-revs という名前のファイルを作成します。

2. [変更履歴] ビューから除外するコミット ハッシュをそのファイルに追加します。 コメントを含め、次のようにファイルを構成することをお勧めします。

   # .git-blame-ignore-revs
   # Removed semi-colons from the entire codebase
   a8940f7fbddf7fad9d7d50014d4e8d46baf30592
   # Converted all JavaScript to TypeScript
   69d029cec8337c616552756310748c4a507bd75a
   

3. 変更をコミットしてプッシュします。

blame ビューでは、コミットによって新しい行が追加された場合にのみ、そのリビジョンが除外されます。 ある行の最後の変更がそのコミットである場合、引き続き blame に表示されます。 "Ignoring revisions in .git-blame-ignore-revs" バナーが表示され、一部のコミットが非表示になっている可能性があることが示されます。

これは、いくつかのコミットがコードに広範な変更を加える場合に役立ちます。 このファイルは、ローカルで git blame を実行する場合にも使用できます。

git blame --ignore-revs-file .git-blame-ignore-revs

ローカル Git を構成して、そのファイルのリビジョンを常に無視することもできます。

git config blame.ignoreRevsFile .git-blame-ignore-revs

[変更履歴] ビューで .git-blame-ignore-revs をバイパスする

ファイルの [変更履歴] ビューに [Ignoring revisions in .git-blame-ignore-revs](.git-blame-ignore-revs でリビジョンを無視する) と表示されている場合でも、.git-blame-ignore-revs をバイパスして通常の [変更履歴] ビューを表示できます。 URL で ~ を SHA に追加すると、 [.git-blame-ignore-revs でリビジョンを無視する] バナーが消えます。

Copilot によるファイルの理解

また、Copilot を使って、ファイル内の特定のコード行について質問することもでき、コードがどのように動作するのかを理解するのに役立ち、新しい問題が発生するリスクを軽減できます。

1. GitHub で、リポジトリに移動し、ファイルを開きます。

2. 次のいずれかの操作を行います。

   • ファイル全体について質問するには、ファイル ビューの右上にある [Copilot] アイコン () をクリックします。

     

   • ファイル内の特定の行について質問するには:

     1. 質問したい最初の行の行番号をクリックし、Shift キーを押しながら選択する最後の行の行番号をクリックします。
     2. 選んだ行について独自の質問をするには、選択部分の右側にある [Copilot] アイコン () をクリックしてから、GitHub Copilot Chat パネルに質問を入力します。
     3. 定義済みの質問をするには、Copilot アイコンの横にあるドロップダウン メニューをクリックして、いずれかのオプションを選びます。
     

3. [Copilot] アイコンをクリックしたら、チャットパネルの下部にある [Ask Copilot] (Copilot に質問する) ボックスに質問を入力し、Enter キーを押します。

   たとえば、ファイル全体について質問する場合は、次のように入力できます。

   • Explain this file.
   • How could I improve this code?
   • How can I test this script?

   特定の行について質問する場合は、次のように入力できます。

   • Explain the function at the selected lines.
   • How could I improve this class?
   • Add error handling to this code.
   • Write a unit test for this method.

   Copilot は、パネル内のリクエストに応答します。

4. 必要に応じて、質問を送信した後、テキスト ボックス内の をクリックして回答を停止できます。

5. フォローアップの質問をして、会話を続けることができます。 たとえば、「tell me more」(もっと詳しく) と入力することで、Copilot を取得して最新のコメントを展開できます。