ファイルの表示と理解

ファイルの内容を調べ、経時的に変更を追跡して、新しいコードベースとその進化を理解します。

この記事の内容

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

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

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

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

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

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

    ファイルのスクリーンショット。 ヘッダーには、[未加工] というボタンが濃いオレンジ色の枠線で囲まれています。

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

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

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

Tip

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

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

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

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

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

    blame ビューでのコミットのスクリーンショット。 コミット メッセージとバージョン アイコンが濃いオレンジで囲まれています。

  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. 変更をコミットしてプッシュします。

ここで、[変更履歴] ビューにアクセスしても、一覧表示されたリビジョンは変更履歴に含まれません。 [.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 でリビジョンを無視する] バナーが消えます。