기억나는 것이 이름인지 문장인지 정합니다
GitHub에서 필요한 파일을 찾을 때 README라는 이름을 기억하는 경우와 설정을 설명한 문장만 기억하는 경우는 출발점이 다릅니다. 파일 이름을 찾는 칸에 본문 문장을 길게 넣었다면 원하는 결과가 나오지 않을 수 있습니다. 우선 내가 가진 단서가 이름·폴더 경로인지 내용인지 나눕니다.
아래의 paper-kit 저장소와 파일 이름은 설명용 가정입니다. 실제 프로젝트의 구조나 특정 파일 존재를 주장하지 않습니다. 새 도구를 설치하거나 저장소를 복제하지 않고 웹 화면에서 파일 위치를 찾는 데 집중하는 연습입니다. 파일을 찾았다고 그 코드를 실행할 필요도 없습니다.
저장소와 선택된 브랜치를 확인합니다
같은 이름의 저장소가 여러 소유자 아래에 있을 수 있습니다. 검색을 시작할 때 소유자와 저장소 이름을 함께 확인하고, 현재 선택된 브랜치도 읽습니다. 다른 사람의 복사본이나 오래된 작업 브랜치에서 찾고 있다면 파일이 없는 이유를 잘못 짐작할 수 있습니다.
가상 메모에는 소유자 예시, paper-kit, 현재 확인한 브랜치를 적습니다. 여기서 브랜치를 바꾸는 것은 화면에서 다른 버전을 보는 작업이며 파일을 수정하는 작업과는 다릅니다. 어떤 버전을 확인하려는지 정한 뒤 탐색하면 발견한 경로를 팀원에게 설명하기도 쉽습니다.
Go to file에는 파일이나 폴더 이름을 넣습니다
GitHub 공식 안내는 저장소의 Go to file 검색창에서 파일이나 디렉터리 이름을 찾는 방법을 설명합니다. 검색창 대신 버튼이 보이면 버튼을 열어 이름을 입력합니다. 결과에는 경로가 표시되므로 이름이 같은 파일이 여러 개일 때 어느 폴더에 있는지 구분할 수 있습니다.
연습에서는 guide.md를 찾는다고 가정합니다. docs/guide.md와 examples/guide.md가 모두 보인다면 맨 위 결과라는 이유만으로 하나를 고르지 않습니다. 안내 문서를 찾는지 예제 파일을 찾는지 목적과 경로를 맞춘 다음 파일을 열고 제목이나 첫 부분을 확인합니다.
| 가진 단서 | 먼저 할 일 | 기록할 범위 |
|---|---|---|
| guide.md라는 이름 | Go to file 사용 | 일치한 전체 경로 |
| 설명 문장만 기억남 | 저장소 범위의 내용 검색 | 검색어와 저장소 |
| 같은 이름이 여러 곳 | 폴더와 파일 내용을 대조 | 선택한 이유 |
| 검색 결과가 없음 | 브랜치·범위·제외 항목 확인 | 확인한 범위만 기록 |
본문의 단어는 내용 검색으로 찾습니다
파일 이름을 모르는 대신 문장이나 함수 이름을 기억한다면 코드 검색으로 전환할 수 있습니다. 이때 저장소 범위를 확인하고 필요한 경우 경로 조건을 사용합니다. GitHub 코드 검색의 path 조건은 파일 경로를 좁히는 용도이며, 내용 검색과 어떤 조건을 함께 썼는지 메모해 두면 다시 찾기 쉽습니다.
파일 찾기 결과가 비어 있다고 파일이 어디에도 없다고 결론 내리지는 않습니다. GitHub 공식 문서는 파일 찾기의 기본 제외 디렉터리도 안내합니다. 검색한 방식과 범위를 먼저 적고, 경로를 알고 있다면 저장소 폴더를 직접 살펴보거나 해당 조건을 지원하는 검색으로 확인합니다.
파일을 열면 이름보다 전체 경로를 기록합니다
가상 연습에서 docs/guide.md를 찾았다면 저장소·브랜치·전체 경로를 한 줄로 남깁니다. README나 config처럼 흔한 파일 이름만 메신저에 적으면 상대가 다른 폴더의 동명 파일을 열 수 있습니다. 필요한 문단이나 줄을 함께 가리키면 검토할 범위를 좁힐 수 있습니다.
계속 바뀌는 브랜치의 주소를 공유하면 이후 내용이 달라질 수 있습니다. 특정 시점의 내용을 검토 근거로 남기려는 경우에는 관련 글에서 설명한 커밋 기준 고정 링크를 사용할 수 있습니다. 단순 탐색 주소와 당시 내용을 남기는 링크 중 어떤 것이 필요한지 선택하세요.
찾지 못했을 때는 실패 범위를 짧게 남깁니다
검색이 끝나도 필요한 파일을 찾지 못할 수 있습니다. 그때는 확인한 저장소와 브랜치, 사용한 이름이나 내용 단서를 남깁니다. 이런 메모가 있으면 다른 사람이 같은 검색을 반복하지 않고 경로 변경, 다른 브랜치, 문서 위치 등을 살펴볼 수 있습니다.
이 연습의 완료 기준은 프로젝트 전체를 이해하는 것이 아니라 필요한 자료의 위치를 확인하는 것입니다. 찾은 파일이 현재 실행 환경에 적용되는지나 내용이 올바른지는 다음 검토 과제입니다. 이름을 찾은 결과, 본문을 읽은 결과, 실제로 동작을 확인한 결과를 한꺼번에 완료로 표시하지 않습니다.
직접 적용해 보기: 이름 검색과 내용 검색
가상의 저장소에서 guide.md와 설정을 설명한 문장을 혼동해 검색한 상황입니다.
- 01
파일 이름과 본문 단서를 구분합니다.
- 02
저장소·브랜치를 확인하고 적합한 검색을 사용합니다.
- 03
찾은 파일의 전체 경로와 검토 위치를 남깁니다.
남길 결과물
다른 사람이 같은 파일을 다시 찾을 수 있는 탐색 메모입니다.
여기서 자주 놓치는 점
파일 찾기의 결과 없음만으로 저장소에서 파일이 삭제됐다고 단정하지 않습니다.
편집팀이 구성한 설명용 예시입니다. 실제 이용 후기나 측정 결과가 아닙니다.
