[Linux] Linux tree 명령어 완전 정복: 프로젝트 구조를 한눈에! 🌲

Linux tree 명령어는 디렉터리 구조를 계층형 트리 형태로 출력해 프로젝트 분석과 소스 코드 파악을 빠르게 도와준다. 옵션별 기능과 실전 활용법까지 상세히 정리했다.

1. Linux tree 명령어가 중요한가?

프로젝트 규모가 커질수록 “폴더 안에 폴더, 그 안에 또 폴더”가 반복되면서 구조 파악이 어려워진다.
많은 초보자는 ls로만 확인하려고 하지만, 일정 규모를 넘는 순간 구조 전체를 이해하는 일 자체가 시간 낭비가 된다.

이럴 때 필요한 것이 디렉터리를 계층형 트리(tree) 구조로 시각화해주는 명령어다.
바로 tree.

tree는 단순히 폴더를 나열하는 도구가 아니라:

• 프로젝트 뼈대를 빠르게 이해하고
• 설정 파일 위치를 즉시 확인하며
• README나 기술 문서에 바로 삽입할 수 있고
• 디버깅 시 전체 구조를 시각적으로 정리해주며
• Python, Node.js, OpenWrt처럼 구조가 복잡한 환경에서 구조적 문제를 빨리 찾게 해주는

분석 + 문서화 + 유지보수 속도까지 높여주는 실전 도구다.

Linux tree 명령어 출력 구조 예시

---

2. tree 명령어 설치 방법

대부분의 Linux 배포판에서는 기본 설치가 아니므로 패키지 설치가 필요하다.

Ubuntu / Debian

sudo apt-get install tree

 

CentOS / RHEL / Fedora

sudo yum install tree

 

arch

sudo pacman -S tree

 

OpenWrt

OpenWrt에는 tree가 기본 패키지로 존재한다.

opkg update
opkg install tree

 

---

3. tree 명령어 기본 사용법

가장 기본적인 사용법:

tree

 

출력 예:

.
├── include
├── src
│   ├── main.c
│   └── module
│       └── mod.c
└── README.md

 

. (현재 디렉터리)를 기준으로 모든 파일과 폴더를 계층 구조로 출력한다.

절대·상대 출력 형태 비교

tree 명령어 출력 구조 이해하기

---

4. tree 명령어 기본 옵션 정리(실무에서 가장 많이 사용)

tree는 시각화를 위한 옵션이 매우 많지만, 실제로 가장 자주 쓰이는 옵션은 다음과 같다.

옵션	설명
-L N	출력 깊이 제한
-d	디렉터리만 표시
-a	숨김 파일 포함
-f	전체 경로 출력
-I pattern	특정 파일·폴더 제외
-P pattern	특정 패턴만 포함
-R	하위 트리 재귀
-h	파일 크기 표시 (human readable)
-s	파일 크기를 바이트로 표시
-p	권한 표시
-u	owner 표시
-g	group 표시
--du	디렉터리 크기 총합 표시

---

5. 옵션별 실전 예제

1) -L 옵션: 깊이 제한하여 보기 좋게 출력

대규모 프로젝트에서는 전체 트리 출력이 너무 방대할 수 있다.
이때 -L 옵션으로 깊이를 제한하면 구조를 단번에 이해할 수 있다.

예제

tree -L 2

 

출력 예:

.
├── include
├── src
│   ├── main.c
│   └── module
└── README.md

 

2) -d 옵션: 디렉터리만 보고 싶을 때

대규모 프로젝트에서 파일 제외하고 폴더 구조만 보고 싶을 때 쓴다.

tree -d

 

출력 예:

.
├── include
├── src
│   ├── main.c
│   └── module
└── README.md

 

프로젝트 구조 분석할 때 가장 많이 쓰는 조합은:

tree -d -L 3

 

3) -a 옵션: 숨김 파일까지 포함

Linux는 . 으로 시작하는 파일을 숨김 처리한다.
-a 옵션으로 숨김 파일까지 모두 보여준다.

예:

tree -a

 

.git, .config, .vscode 같은 폴더가 보이기 시작한다.

4) -I 옵션: 특정 파일·디렉터리 제외

특정 패턴을 제외하고 보고 싶을 때 매우 강력하다.

예:

tree -I "node_modules|build"

 

여러 디렉터리를 제외하고 싶을 때는 |로 묶으면 된다.

5) -P 옵션: 특정 패턴만 포함

예:

tree -P "*.c"

 

출력:

main.c
mod.c

 

C 프로젝트의 파일 구조만 보고 싶을 때 매우 유용하다.

6) -f 옵션: 전체 경로로 출력

일반 tree는 상대 경로(현재 디렉터리 기준)만 보여주지만, -f를 사용하면 전체 경로를 표시한다.

예:

tree -f

 

출력:

./src/module/mod.c
./README.md

 

스크립트에서 디렉터리 추적을 자동화할 때 유용하다.

7) -p, -u, -g : 파일 권한 및 소유자 확인

tree는 파일 구조뿐 아니라 권한도 함께 볼 수 있다.

예:

tree -pug

 

출력 예:

-rw-r--r-- user group main.c

 

시스템 관리자에게 매우 유용한 기능이다.

8) -h / -s / --du : 파일·폴더 크기 시각화

사람이 읽기 쉬운 단위(KB, MB)로 출력

-h

바이트 단위 파일 크기 출력

-s

 

디렉터리 크기 총합 표시

--du

예:

tree -h --du

 

tree -L, -d, -P 옵션 조합 활용 예시

---

6. 실전 활용 시나리오 12가지

1) 프로젝트 전체 구조 한눈에 파악

오픈소스 프로젝트 다운로드 후 가장 먼저 실행하는 명령:

tree -L 2

 

2) Python 프로젝트 디렉터리 분석

tree -h -L 3 -I "__pycache__"

 

3) Node.js 프로젝트 구조 확인

tree -L 3 -I "node_modules"

 

4) OpenWrt 빌드 시스템 구조 이해

OpenWrt는 디렉터리가 수십 개 이상이므로 tree 사용이 매우 유용하다.

예:

tree -L 2 -d

 

출력 예:

.
├── package
├── scripts
├── target
├── toolchain
└── tools

 

5) 설정 파일 찾기

예:

tree -P "*.conf"

 

6) gcc 헤더 파일 위치 찾기

tree /usr/include -P "*.h" -L 2

 

7) 권한 문제 디버깅

tree -pug -L 3 /var/www

 

8) 파일 용량이 비정상적으로 큰 폴더 찾기

tree -h --du | sort -h

 

9) README.md에 디렉터리 구조 삽입

많은 오픈소스 README들은 tree 형식 출력물을 포함한다.

tree -L 3 > tree.txt

 

10) 백업 스크립트 경로 검증

tree -f > backup_paths.log

 

11) gitignore 검증

tree -a -I "$(cat .gitignore | tr '\n' '|')"

 

12) C 프로젝트의 include 구조 확인

tree -L 3 -P "*.h"

 

---

7. tree 명령어의 숨겨진 기능

1) ANSI 색상 출력

기본적으로 컬러가 표시되지만, 강제 적용 가능:

tree -C

 

2) 시각화 노드 문자 변경

ASCII 모드:

tree -A

 

유니코드 모드:

tree -N

 

3) 정렬 기준 변경

파일 크기 기준:

tree --sort=size

 

확장자 기준:

tree --sort=extension

 

---

8. 사용 시 주의사항

1) 대규모 파일 시스템 출력 시간 증가

수십만 파일을 가진 디렉터리에서 tree를 실행하면 오래 걸릴 수 있다.
→ -L 옵션으로 제한하는 것이 안정적.

2) 숨김 파일 많으면 출력 너무 길어짐

→ -I로 제외 필수.

3) root로 실행 시 홈 디렉터리 구조 노출 가능

→ 권한에 주의

---

9. tree 명령어 자주 묻는 질문(FAQ)

Q1. tree가 설치 안 되어 있어요.

대부분의 배포판에서 기본 설치가 아니므로 패키지 설치가 필요하다.

Q2. 특정 폴더만 제외하고 출력할 수 있나요?

가능하다. -I "폴더명|폴더명" 패턴을 사용하면 된다.

Q3. 파일 크기까지 보고 싶어요.

tree -h --du

 

Q4. 권한·소유자를 함께 볼 수 있나요?

가능하다.

tree -pug

 

Q5. Markdown에서 tree 결과를 보기 좋게 출력하려면?

코드블록(```)에 넣으면 된다.

---

10. 마무리 - Linux tree 명령어는 어떤 효과를 주는가?

tree 명령어는 구조를 “보이게” 만드는 도구다.
디렉터리 구조를 정확히 이해하면 개발 속도는 물론 디버깅 능력도 크게 올라간다. .

“구조를 이해하는 사람은 문제를 더 적게 만들고 더 빠르게 해결한다.”
tree는 그 구조를 ‘눈앞에 보이게’ 해준다.

 

 

이전글 보기

[LINUX] cd 명령어 사용법 200% 이해하기: 실전 사례 + 꿀팁 모음 📘

 

다음글 보기

[Linux] mkdir -p 실무 활용법부터 오류 해결까지 한 번에 배우기 📂