01

파일명 뒤에 무엇이 붙는지 확인합니다

파일명 뒤에 무엇이 붙는지 확인합니다 핵심 안내 도식
핵심 읽기 · 파일명 뒤에 무엇이 붙는지 확인합니다

편집기 위의 Breadcrumbs는 현재 위치를 보여 주는 탐색 막대입니다. 폴더와 파일 경로에 이어 현재 커서가 있는 함수나 클래스 같은 심볼이 표시될 수 있습니다. 파일명 뒤의 항목까지 모두 디스크 폴더라고 생각하면 경로를 잘못 옮길 수 있습니다.

예를 들어 src, pages, home.js, renderHome이 차례로 보인다면 마지막 항목이 어떤 역할인지 확인합니다. 이 예시는 가상의 프로젝트 구조이며 현재 사용자의 파일을 설명하는 것은 아닙니다.

02

파일 위치와 코드 위치를 나눠 봅니다

파일 위치와 코드 위치를 나눠 봅니다 핵심 안내 도식
핵심 읽기 · 파일 위치와 코드 위치를 나눠 봅니다

파일을 찾는 데에는 폴더와 파일명이 필요합니다. 그 안의 특정 구현을 찾는 데에는 함수명이나 줄 위치가 도움이 됩니다. 협업 메모에서도 “어느 파일”과 “파일의 어느 부분”을 나누어 적어 보세요.

같은 이름의 index.js가 여러 폴더에 있으면 탭 이름만으로는 충분하지 않습니다. Breadcrumbs의 상위 폴더를 읽어 어떤 파일인지 확인한 다음 코드 위치를 살펴봅니다.

03

경로 항목을 선택해 이동 범위를 봅니다

경로 항목을 선택해 이동 범위를 봅니다 핵심 안내 도식
핵심 읽기 · 경로 항목을 선택해 이동 범위를 봅니다

공식 문서는 경로 항목을 선택하면 같은 단계의 폴더나 파일을 고르는 목록이 나온다고 설명합니다. 심볼을 지원하는 언어에서는 심볼 목록으로 코드 위치를 탐색할 수 있습니다.

이동 전에 현재 열린 파일을 기억하려고 전체 경로를 복사하는 대신 필요한 폴더 이름과 파일 이름을 짧게 메모해도 됩니다. 연습 중에는 파일을 수정하거나 이름을 바꿀 필요가 없습니다. 목록을 읽고 원하는 위치로 이동하는 것만 확인합니다.

한눈에 비교하기
상황별 확인 항목 — 작은 화면에서는 표를 좌우로 밀어 볼 수 있습니다.
가상 표시파일 위치파일 안 위치
pages 쪽 index.jssrc/pages/index.jsrenderHome
widgets 쪽 index.jssrc/widgets/index.jsrenderCard
심볼 미표시확인한 파일 경로본문에서 직접 확인
04

심볼이 안 보여도 함수가 없다고 결론 내리지 않습니다

심볼이 안 보여도 함수가 없다고 결론 내리지 않습니다 핵심 안내 도식
핵심 읽기 · 심볼이 안 보여도 함수가 없다고 결론 내리지 않습니다

심볼 표시에는 해당 언어의 지원이 필요하며 Breadcrumbs의 표시 설정도 영향을 줍니다. 파일 경로만 보인다는 이유로 내용이 비었다고 판단하지 마세요. 편집기 본문과 Outline의 실제 표시를 함께 확인할 수 있습니다.

이 글을 따라 하려고 새 확장을 설치하거나 프로젝트 설정을 바꿀 필요는 없습니다. 현재 화면이 제공하는 범위부터 확인하고, 없는 표시는 “미표시”로 메모합니다.

05

같은 파일명 두 개로 확인 연습을 합니다

같은 파일명 두 개로 확인 연습을 합니다 핵심 안내 도식
핵심 읽기 · 같은 파일명 두 개로 확인 연습을 합니다

가상의 src/pages/index.js와 src/widgets/index.js가 있다고 합시다. 고칠 대상은 pages 쪽의 renderHome 함수입니다. 두 파일을 비교할 때 마지막 파일명만 적지 않고 폴더 경로까지 읽습니다.

아래 표는 실행 가능한 수정 지시가 아니라 위치를 전달하는 예시입니다. 메모를 받은 사람이 파일부터 열고 그 안의 함수로 찾아갈 수 있는지 확인해 보세요.

06

코드 위치를 공유한 뒤 같은 대상을 열어 봅니다

코드 위치를 공유한 뒤 같은 대상을 열어 봅니다 핵심 안내 도식
핵심 읽기 · 코드 위치를 공유한 뒤 같은 대상을 열어 봅니다

메모의 경로로 파일을 찾은 다음 실제 본문에서 함수명을 확인합니다. 파일이 이동했거나 함수 이름이 바뀌었으면 이전 메모가 현재 위치를 가리키지 않을 수 있습니다. 줄 번호도 내용 수정에 따라 달라질 수 있습니다.

리뷰 근거를 오래 유지해야 한다면 저장소의 특정 버전 링크를 사용하는 기존 안내를 참고하세요. Breadcrumbs는 현재 편집 위치를 찾는 도구이며 변경 이력 자체를 고정해 주는 링크는 아닙니다.

WORKBOOK

직접 적용해 보기: 파일 경로와 코드 위치

가상의 두 index.js 중 pages 폴더의 renderHome 함수를 지정합니다.

  1. 01

    상위 폴더와 파일명을 함께 읽습니다.

  2. 02

    파일 뒤 심볼을 코드 위치로 구분합니다.

  3. 03

    메모대로 다시 열어 같은 함수를 확인합니다.

남길 결과물

파일 경로와 내부 심볼을 분리한 작업 위치 메모입니다.

여기서 자주 놓치는 점

심볼 이름을 폴더 경로에 붙여 존재하지 않는 파일 주소를 만들지 않습니다.

편집팀이 구성한 설명용 예시입니다. 실제 이용 후기나 측정 결과가 아닙니다.