시스템 & 인프라/Linux & DevOps

[리눅스 한 학기 살기 #10] tree 명령어로 디렉터리 구조 보기: 동작 순서와 옵션

kugorang 2025. 5. 28. 20:12
728x90

TL;DR (세 줄 요약)

  1. tree는 디렉터리(폴더) 안의 파일과 하위 디렉터리를 선으로 이어진 나무 모양 목록으로 보여 주는 명령어입니다. 파일이 수십 개만 넘어도 ls만으로는 구조를 파악하기 어렵습니다.
  2. tree는 디렉터리를 열어 항목을 읽고, 하위 디렉터리마다 같은 일을 반복합니다. 출력할 때는 현재 항목이 마지막인지에 따라 ├── 또는 └──를 붙입니다.
  3. -L로 깊이를 제한하고, -a로 숨김 파일을 포함하고, -I로 제외할 이름을, -P로 포함할 이름을 지정합니다. README에 구조를 넣을 때는 tree -L 2 -I node_modules 정도가 실용적입니다.

이 글은 "리눅스 한 학기 살기" 과제의 10주 차 기록입니다.

1. tree는 무엇을 출력하나요?

폴더 세 개가 선으로 이어진 모양 아래에 tree라고 적힌 그림
그림. 이 글의 tree는 자료구조가 아니라 리눅스 명령어입니다.

ls는 디렉터리 하나의 항목을 나열합니다. tree는 현재 디렉터리부터 그 아래 전체를 차례로 내려가면서, 어떤 디렉터리 안에 무엇이 들어 있는지를 선으로 이어 보여 줍니다. 마지막 줄에는 "N directories, M files"처럼 디렉터리와 파일의 개수를 붙입니다.

$ tree
.
├── src
│   ├── main.c
│   └── util.c
└── Makefile

1 directory, 3 files

2. tree는 어떤 순서로 동작하나요?

  1. 대상 경로를 엽니다(opendir).
  2. 항목을 하나씩 읽습니다(readdir). 현재 디렉터리를 뜻하는 .과 상위 디렉터리를 뜻하는 ..은 건너뜁니다.
  3. 각 항목의 종류와 크기를 확인합니다(lstat).
  4. 이름순으로 정렬합니다.
  5. 마지막 항목인지 판단해서 ├── 또는 └──를 붙여 출력합니다.
  6. 항목이 디렉터리이면 그 안으로 들어가 1~5번을 반복합니다.

opendir, readdir, lstat는 운영체제가 제공하는 함수입니다. 6번처럼 함수가 자기 자신을 다시 호출해서 같은 일을 반복하는 방식을 재귀라고 부릅니다.

정렬은 목록을 메모리에 모아서 합니다. 그래서 항목이 수십만 개인 디렉터리에서는 메모리를 많이 씁니다. 그럴 때는 -L로 깊이를 제한하거나 --filelimit으로 항목 수가 많은 디렉터리를 건너뜁니다.

3. 자주 쓰는 옵션은 무엇인가요?

옵션하는 일
-a숨김 파일을 포함합니다. 기본으로는 이름이 점(.)으로 시작하는 항목을 뺍니다.
-d디렉터리만 표시합니다.
-L 22단계 아래까지만 표시합니다.
-f항목을 전체 경로로 표시합니다.
-i들여쓰기 선 없이 출력합니다. 경로 목록으로 쓸 때 유용합니다.
-P '*.c' / -I 'node_modules'패턴과 일치하는 것만 표시합니다 / 패턴과 일치하는 것을 제외합니다.
-p -u -g -s -h -D권한 / 소유자 / 그룹 / 크기 / 읽기 쉬운 단위 / 수정 시각을 함께 표시합니다.
-t -r -v수정 시각순 정렬 / 역순 정렬 / 버전 번호를 숫자 크기대로 정렬합니다.
-C -n -A색을 항상 사용 / 색을 사용하지 않음 / ASCII 문자로 선을 그립니다.
-J -X -H URLJSON / XML / HTML 형식으로 출력합니다.
--noreport마지막 요약 줄을 생략합니다.
tree -L 2 -I node_modules -I .git
tree -a -L 1
tree -d -f -i
tree -pugsh -D -L 1
tree -J -L 2 > structure.json
tree --filelimit 200 /
  • 1번째 줄: 2단계까지만 보여 주고 node_modules와 .git은 제외합니다.
  • 2번째 줄: 숨김 파일을 포함해 1단계만 보여 줍니다.
  • 3번째 줄: 디렉터리만 전체 경로로, 선 없이 출력합니다.
  • 4번째 줄: 권한, 소유자, 그룹, 크기, 수정 시각을 함께 보여 줍니다.
  • 5번째 줄: 구조를 JSON 파일로 저장합니다.
  • 6번째 줄: 루트(/)부터 보되 항목이 200개를 넘는 디렉터리는 건너뜁니다.

4. tree는 어디에 쓰나요?

  • README에 프로젝트 구조를 넣을 때: tree -L 2 -I .git -I node_modules
  • 파일 시스템 구조를 공부할 때: tree -L 1 /로 루트 아래의 큰 디렉터리만 확인합니다.
  • 권한을 점검할 때: tree -pug -L 2로 소유자와 권한을 함께 확인합니다.
  • 배포할 파일을 검증할 때: CI 로그에 tree -n --noreport 결과를 남겨서 어떤 파일이 포함됐는지 기록합니다.

5. 어떻게 설치하나요?

sudo apt install tree      # Debian/Ubuntu
sudo dnf install tree      # Fedora/Rocky
sudo pacman -S tree        # Arch
brew install tree          # macOS
tree --version

일부 배포판에는 기본으로 설치되어 있지 않습니다. 사용하는 배포판에 맞는 명령어 한 줄을 실행하고, tree --version으로 설치를 확인합니다. 터미널에서 선이 깨져 보이면 -A 또는 --charset 옵션으로 선에 쓰는 문자를 바꿉니다.

6. 비슷한 도구와는 무엇이 다른가요?

도구특징
ls -R기본으로 설치되어 있습니다. 하위 디렉터리까지 보여 주지만 나무 모양이 아니라서 구조가 한눈에 보이지 않습니다.
find조건으로 파일을 찾는 데 강합니다. 결과는 경로 목록이고 나무 모양이 아닙니다.
ncdu디스크 사용량을 디렉터리 구조로 보여 주고 삭제도 할 수 있습니다.
exa --tree색과 git 상태를 함께 보여 줍니다. exa는 개발이 멈췄고, 지금은 이를 이어받은 eza가 쓰입니다.
broot화면에서 직접 탐색하고 조작하는 대화형 도구입니다.

자주 묻는 질문 (FAQ)

Q1. tree 출력이 너무 길어서 화면을 넘어갑니다.

-L로 깊이를 제한하고, -I로 제외할 디렉터리(node_modules, .git, venv)를 지정합니다. 결과를 파일로 남기려면 tree -L 3 -o tree.txt처럼 -o를 씁니다.

Q2. 심볼릭 링크를 따라가게 하면 출력이 너무 길어집니다.

심볼릭 링크는 다른 파일이나 디렉터리를 가리키는 바로 가기입니다. tree는 기본으로 링크를 따라가지 않습니다. -l을 주면 디렉터리를 가리키는 링크를 따라갑니다. 서로를 가리키는 순환 링크는 감지하면 피하지만, 따라가는 범위가 넓어져 출력이 크게 늘어날 수 있습니다. -L로 깊이를 함께 제한합니다.

Q3. 숨김 파일에 -P 패턴이 적용되지 않습니다.

기본으로 숨김 파일은 목록에서 빠지므로 패턴 검사 대상도 아닙니다. -a를 함께 지정해야 숨김 파일까지 패턴이 적용됩니다.

수정 안내

이 글은 2026년 11월 21일에 다시 썼습니다. FAQ Q2는 tree 설명서에 맞게 고쳤습니다. tree는 -l 옵션을 써도 순환하는 링크를 감지하면 따라가지 않습니다. exa가 eza로 이어졌다는 내용도 추가했습니다.

참고 자료

같은 주제의 다른 글: [리눅스 한 학기 살기 #7] Vim 입문: 모드, 저장과 종료, 이동, 매크로, [리눅스 한 학기 살기 #8] ca-certificates란? 사내 CA 인증서 추가 방법, [리눅스 한 학기 살기 #9] tldr로 리눅스 명령어 예제 찾기: man과의 차이, [리눅스 한 학기 살기 #11] htop 사용법: top과의 차이, CPU·메모리 수치 읽기, [리눅스 한 학기 살기 #12] nmap으로 포트 스캔하기: 동작 원리와 법적 주의사항

728x90
728x90