Skip to main content

파일 보기 및 이해

파일 콘텐츠를 탐색하고 시간에 따른 변경 내용을 추적하여 새 코드베이스와 그 발전을 이해합니다.

GitHub는 원시 콘텐츠를 보고, 특정 줄의 변경 내용을 추적하고, 시간이 지남에 따라 파일의 콘텐츠가 어떻게 발전했는지 살펴보는 도구를 제공합니다. 이러한 인사이트는 코드가 개발된 방법, 현재 목적, 구조를 표시하여 효과적으로 기여하는 데 도움이 됩니다.

원시 파일 콘텐츠 보기 또는 복사

원시 보기를 사용하면 스타일 없이 파일의 원시 콘텐츠를 보거나 복사할 수 있습니다.

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 보려는 파일을 클릭합니다.

  3. 파일 보기의 오른쪽 위 모서리에서 Raw를 클릭합니다.

    파일의 스크린샷. 머리글에는 "Raw"라는 레이블이 달린 버튼이 진한 주황색 테두리로 강조되어 있습니다.

  4. 필요에 따라 Raw 파일 콘텐츠를 복사하려면 파일 보기의 오른쪽 위 모서리에서 을 클릭합니다. Raw 파일을 다운로드하려면 을 클릭합니다.

파일에 대한 줄별 수정 기록 보기

블레임 보기 내에서 전체 파일에 대한 줄별 수정 기록을 볼 수 있습니다.

명령줄에서 을 사용하여 한 파일 내의 줄 수정 기록을 볼 수도 있습니다. 자세한 내용은 Git 설명서를 참조하세요.

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 줄 기록을 보려는 파일을 클릭하여 엽니다.

  3. 파일 콘텐츠 위에서 'Blame' 버튼을 클릭합니다. 이 보기는 파일의 코드를 커밋으로 구분하여 줄별 수정 기록을 제공합니다. 각 커밋에는 작성자, 커밋 설명 및 커밋 날짜가 나열됩니다.

  4. 특정 커밋 전에 파일 버전을 보려면 을(를) 클릭합니다. 또는 특정 커밋에 대한 자세한 내용을 보려면 커밋 메시지 클릭합니다.

    커밋의 블레임 뷰를 보여주는 스크린샷입니다. 커밋 메시지 및 버전 아이콘은 진한 주황색으로 표시됩니다.

  5. 원시 코드 보기로 돌아가려면 파일 콘텐츠 위에서 코드를 클릭합니다.

    • 파일 콘텐츠 위에서 Markdown 파일을 보는 경우 미리 보기를 클릭하여 Markdown 형식이 적용된 보기로 반환할 수도 있습니다.

Blame 보기에서 커밋 무시

리포지토리의 루트 디렉터리에 있어야 하는 파일에 지정된 모든 수정 버전은 Git의 구성 설정을 사용하여 Blame 보기에서 숨겨집니다. 자세한 내용은 Git 설명서의 를 참조하세요.

  1. 리포지토리의 루트 디렉터리에서 이름이 인 파일을 만듭니다.

  2. Blame 보기에서 제외하려는 커밋 해시를 해당 파일에 추가합니다. 주석을 포함하여 파일을 다음과 같이 구성하는 것이 좋습니다.

    # .git-blame-ignore-revs
    # Removed semi-colons from the entire codebase
    a8940f7fbddf7fad9d7d50014d4e8d46baf30592
    # Converted all JavaScript to TypeScript
    69d029cec8337c616552756310748c4a507bd75a
    
  3. 변경 내용을 커밋하고 푸시합니다.

블레임 보기에서 수정 내용은 커밋이 새 줄을 도입하거나 기존 줄을 수정한 경우 제외됩니다. 커밋이 해당 줄을 마지막으로 수정했다면 blame 보기에서도 여전히 표시됩니다. 일부 커밋이 숨겨져 있을 수 있음을 나타내는 “Ignoring revisions in .git-blame-ignore-revs” 배너가 표시됩니다:

파일에 대한 blame 보기 화면을 보여주는 스크린샷입니다. 파란색 “수정 버전 무시” 배너에는 주황색으로 윤곽이 표시된 “.git-blame-ignore-revs”에 대한 링크가 포함되어 있습니다.

이 기능은 몇 가지 커밋이 코드를 광범위하게 변경하는 경우에 유용할 수 있습니다. 로컬로 을 실행할 때도 파일을 사용할 수 있습니다.

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

해당 파일의 수정 버전을 항상 무시하도록 로컬 git을 구성할 수도 있습니다.

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

블레임 보기에서 우회하기

파일의 블레임 보기에 .git-blame-ignore-revs에서 수정 내역을 무시하는 것이 표시될 경우, 그래도 이를 무시하고 일반 블레임 보기를 볼 수 있습니다. URL에 SHA를 추가하면 .git-blame-ignore-revs 배너에서 무시된 수정 버전이 사라집니다.