ファイルの表示と理解

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

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

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

GitHub で、リポジトリのメインページに移動します。
表示するファイルをクリックします。
ファイルビューの右上隅にある [未加工] をクリックします。
必要に応じて、生ファイルの内容をコピーするには、ファイルビューの右上隅にあるをクリックします。生ファイルをダウンロードするには、[] をクリックしてください。

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

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

Tip

コマンドラインでは、git blame を使用してファイル内の行のリビジョン履歴を表示することもできます。詳細については、Gitgit blame のドキュメントを参照してください。

GitHub で、リポジトリのメインページに移動します。
クリックして、表示したい行の履歴のファイルを開きます。
ファイルの内容の上にある [Blame] をクリックしてください。このビューには、1 行ずつのリビジョン履歴とコミットごとに区切られたファイル内のコードが表示されます。各コミットには、作成者、コミットの説明、コミット日が一覧表示されます。
特定のコミットの前にあるファイルのバージョンを表示するには、をクリックします。または、特定のコミットの詳細を表示するには、コミットメッセージをクリックします。
生コードビューに戻すには、ファイルの内容の上にある [コード] をクリックします。
- マークダウンファイルを表示している場合は、ファイルの内容の上にある [プレビュー] をクリックして、Markdown の書式設定が適用されたビューに戻ることもできます。

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

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

リポジトリのルートディレクトリに .git-blame-ignore-revs という名前のファイルを作成します。
[変更履歴] ビューから除外するコミットハッシュをそのファイルに追加します。コメントを含め、次のようにファイルを構成することをお勧めします。
```
# .git-blame-ignore-revs
# Removed semi-colons from the entire codebase
a8940f7fbddf7fad9d7d50014d4e8d46baf30592
# Converted all JavaScript to TypeScript
69d029cec8337c616552756310748c4a507bd75a
```
変更をコミットしてプッシュします。

ここで、[変更履歴] ビューにアクセスしても、一覧表示されたリビジョンは変更履歴に含まれません。 [.git-blame-ignore-revs でのリビジョンの無視] バナーが表示され、一部のコミットが非表示になっている可能性があることが示されます。

"ipc-main-internal.ts" ファイルの Blame ビューのスクリーンショット。情報が "Ignoring revisions in .git-blame-ignore-revs" であることが青のバナーからわかります。 .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 によるファイルの理解

Note

GitHub Copilot のサブスクリプションが必要です。詳しくは、「GitHub Copilot とは何ですか?」を参照してください。

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

GitHub で、リポジトリに移動し、ファイルを開きます。
次のいずれかの操作を行います。
- ファイル全体について質問するには、ファイルビューの右上にある [Copilot] アイコン () をクリックします。
- ファイル内の特定の行について質問するには:
  1. 質問したい最初の行の行番号をクリックし、Shift キーを押しながら選択する最後の行の行番号をクリックします。
  2. 選んだ行について独自の質問をするには、選択部分の右側にある [Copilot] アイコン () をクリックしてから、GitHub Copilot Chat パネルに質問を入力します。
  3. 定義済みの質問をするには、Copilot アイコンの横にあるドロップダウンメニューをクリックして、いずれかのオプションを選びます。
[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 は、パネル内のリクエストに応答します。
必要に応じて、テキストボックスのをクリックして、Copilot が応答を続行しないようにします。
フォローアップの質問をして、会話を続けることができます。たとえば、「tell me more」(もっと詳しく) と入力することで、Copilot を取得して最新のコメントを展開できます。