본문으로 건너뛰기
오픈소스 전체 목록

fd

find를 대신하는 빠르고 쓰기 쉬운 파일 검색 명령줄 도구. Rust로 만들었어요. MIT · Apache-2.0

원본:sharkdp/fd

요약

find를 대신하는 빠르고 쓰기 쉬운 파일 검색 명령줄 도구. Rust로 만들었어요. MIT · Apache-2.0

설명

fd

CICD 버전 정보

[中文] [한국어]

fd는 파일 시스템에서 항목을 찾는 프로그램입니다. find를 대신하는 단순하고 빠르고 사용자 친화적인 도구입니다. find의 강력한 기능을 전부 지원하려는 것은 아니지만, 대부분의 사용 사례에 맞는 합리적인(의견이 담긴) 기본값을 제공합니다.

설치 • 사용법 • 문제 해결

기능

  • 직관적인 문법: find -iname '*PATTERN*' 대신 fd PATTERN.
  • 정규식(기본)과 glob 기반 패턴.
  • 디렉터리를 병렬로 탐색해서 매우 빠릅니다(아래 벤치마크 참고).
  • 파일 종류를 색으로 강조합니다(ls와 같은 방식).
  • 병렬 명령 실행을 지원합니다.
  • 스마트 케이스: 기본은 대소문자를 구분하지 않는 검색이고, 패턴에 대문자가 하나라도 있으면 대소문자를 구분하는 검색으로 바뀝니다*.
  • 기본으로 숨김 디렉터리와 파일은 무시합니다.
  • 기본으로 .gitignore의 패턴은 무시합니다.
  • 명령 이름이 find보다 50% 짧습니다* :-).

데모

데모

사용법

먼저 쓸 수 있는 명령줄 옵션 전체를 보려면 간단한 도움말은 fd -h, 더 자세한 도움말은 fd --help를 실행하세요.

간단한 검색

fd는 파일 시스템에서 항목을 찾도록 만들어졌습니다. 가장 기본적인 검색은 인수 하나, 즉 검색 패턴만 넣고 fd를 실행하는 것입니다. 예를 들어 이름에 netflix가 들어 있던 예전 스크립트를 찾고 싶다고 해 보세요.

> fd netfl
Software/python/imdb-ratings/netflix-details.py

이처럼 인수 하나만 주면 fd는 현재 디렉터리를 재귀적으로 탐색해 netfl 패턴이 들어 있는 항목을 찾습니다.

정규식 검색

검색 패턴은 정규식으로 취급합니다. 여기서는 x로 시작하고 rc로 끝나는 항목을 찾습니다.

> cd /etc
> fd '^x.*rc$'
X11/xinit/xinitrc
X11/xinit/xserverrc

fd가 쓰는 정규식 문법은 여기에 문서화되어 있습니다.

루트 디렉터리 지정하기

특정 디렉터리를 탐색하려면 fd의 두 번째 인수로 주면 됩니다.

> fd passwd /etc
/etc/default/passwd
/etc/pam.d/passwd
/etc/passwd

모든 파일을 재귀적으로 나열하기

fd는 인수 없이도 호출할 수 있습니다. 현재 디렉터리의 모든 항목을 재귀적으로 빠르게 훑어볼 때 매우 유용합니다(ls -R과 비슷합니다).

> cd fd/tests
> fd
testenv
testenv/mod.rs
tests.rs

이 기능으로 특정 디렉터리의 모든 파일을 나열하려면 .나 ^ 같은 모든 것에 맞는 패턴을 써야 합니다.

> fd . fd/tests/
testenv
testenv/mod.rs
tests.rs

특정 파일 확장자 찾기

특정 종류의 파일을 모두 찾고 싶을 때가 많습니다. -e(또는 --extension) 옵션으로 할 수 있습니다. 여기서는 fd 저장소의 모든 Markdown 파일을 찾습니다.

> cd fd
> fd -e md
CONTRIBUTING.md
README.md

-e 옵션은 검색 패턴과 함께 쓸 수 있습니다.

> fd -e rs mod
src/fshelper/mod.rs
src/lscolors/mod.rs
tests/testenv/mod.rs

특정 파일 이름 찾기

주어진 검색 패턴과 정확히 같은 파일을 찾으려면 -g(또는 --glob) 옵션을 쓰세요.

> fd -g libc.so /usr
/usr/lib32/libc.so
/usr/lib/libc.so

숨김 파일과 무시되는 파일

기본으로 fd는 숨김 디렉터리를 탐색하지 않고 숨김 파일을 검색 결과에 보여 주지 않습니다. 이 동작을 끄려면 -H(또는 --hidden) 옵션을 쓰면 됩니다.

> fd pre-commit
> fd -H pre-commit
.git/hooks/pre-commit.sample

Git 저장소(또는 Git 저장소가 들어 있는 디렉터리)에서 일하면 fd는 .gitignore 패턴 중 하나에 맞는 폴더는 탐색하지 않고 파일도 보여 주지 않습니다. 이 동작을 끄려면 -I(또는 --no-ignore) 옵션을 쓰면 됩니다.

> fd num_cpu
> fd -I num_cpu
target/debug/deps/libnum_cpus-f5ce7ef99006aa05.rlib

정말 모든 파일과 디렉터리를 탐색하려면 숨김 기능과 무시 기능을 함께 끌는 -HI를 쓰거나 -u/--unrestricted를 쓰세요.

전체 경로로 맞추기

기본으로 fd는 각 파일의 이름만 맞춥니다. 하지만 --full-path 또는 -p 옵션을 쓰면 전체 경로로 맞출 수 있습니다.

> fd -u -p -g '**/.git/config'
> fd -p '.*/lesson-\d+/[a-z]+.(jpg|png)'

명령 실행

검색 결과를 보여 주기만 하는 대신, 결과로 무언가를 하고 싶을 때가 많습니다. fd는 검색 결과마다 외부 명령을 실행하는 두 가지 방법을 제공합니다.

  • -x/--exec 옵션은 검색 결과 하나하나마다 외부 명령을 (병렬로) 실행합니다.
  • -X/--exec-batch 옵션은 모든 검색 결과를 인수로 외부 명령을 한 번만 실행합니다.

예시

모든 zip 압축 파일을 재귀적으로 찾아 푸는 예:

fd -e zip -x unzip

file1.zip과 backup/file2.zip 두 파일이 있다면 unzip file1.zip과 unzip backup/file2.zip을 실행합니다. 두 unzip 프로세스는 (파일을 충분히 빠르게 찾으면) 병렬로 동작합니다.

모든 *.h와 *.cpp 파일을 찾아 clang-format -i로 제자리에서 자동 서식을 맞추는 예:

fd -e h -e cpp -x clang-format -i

clang-format의 -i 옵션을 별도 인수로 넘길 수 있다는 점에 주목하세요. 그래서 -x 옵션을 맨 뒤에 둔 겁니다.

-x 뒤의 모든 위치 인수는 fd 자신이 아니라 명령 템플릿에 속합니다. 패턴이나 검색 경로도 넘기고 싶다면 -x를 맨 뒤에 두세요.

fd pattern path -x echo

모든 test_*.py 파일을 찾아 좋아하는 편집기로 여는 예:

fd -g 'test_*.py' -X vim

여기서는 vim 인스턴스 하나만 열려고 대문자 -X를 썼다는 점에 유의하세요. test_basic.py와 lib/test_advanced.py 두 파일이 있다면 vim test_basic.py lib/test_advanced.py를 실행합니다.

파일 권한, 소유자, 파일 크기 같은 세부 정보를 보려면 각 결과에 ls를 실행하도록 fd에 시킬 수 있습니다.

fd … -X ls -lhd --color=always

이 패턴이 아주 유용해서 fd는 단축 옵션을 제공합니다. -l/--list-details 옵션으로 이렇게 ls를 실행할 수 있습니다: fd … -l.

-X 옵션은 fd와 ripgrep(rg)를 함께 써서 C++ 소스 파일 같은 특정 종류의 파일 안에서 검색할 때도 유용합니다.

fd -e cpp -e cxx -e h -e hpp -X rg 'std::cout'

모든 *.jpg 파일을 *.png 파일로 변환하는 예:

fd -e jpg -x convert {} {.}.png

여기서 {}는 검색 결과를 대신하는 자리 표시자입니다. {.}는 같지만 파일 확장자가 없습니다. 자리 표시자 문법의 자세한 내용은 아래를 보세요.

-x로 병렬 스레드에서 실행한 명령의 터미널 출력은 섞이거나 깨지지 않으므로, fd -x로 많은 파일에 대한 작업을 간단히 병렬화할 수 있습니다. 디렉터리 안의 파일마다 체크섬을 계산하는 예가 그런 경우입니다.

fd -tf -x md5sum > file_checksums.txt

자리 표시자 문법

-x와 -X 옵션은 명령 템플릿을 (문자열 하나가 아니라) 인수의 나열로 받습니다. 명령 템플릿 뒤에 fd의 옵션을 더 넣고 싶다면 \;로 템플릿을 끝낼 수 있습니다.

예를 들어 fd -x echo \; pattern path는 pattern path를 echo에 넘기는 대신 fd의 인수로 취급합니다. 실제로는 fd pattern path -x echo처럼 쓰는 편이 더 명확한 경우가 많습니다.

명령을 만드는 문법은 GNU Parallel과 비슷합니다.

  • {}: 검색 결과의 경로로 바뀔 자리 표시자 토큰(documents/images/party.jpg).
  • {.}: {}와 같지만 파일 확장자가 없음(documents/images/party).
  • {/}: 검색 결과의 기본 이름(basename)으로 바뀔 자리 표시자(party.jpg).
  • {//}: 찾은 경로의 부모(documents/images).
  • {/.}: 확장자를 때어 낸 기본 이름(party).

자리 표시자를 넣지 않으면 fd가 맨 뒤에 {}를 자동으로 붙입니다.

병렬 실행과 순차 실행

-x/--exec에서는 -j/--threads 옵션으로 병렬 작업 수를 정할 수 있습니다. 순차 실행은 --threads=1을 쓰세요.

특정 파일이나 디렉터리 제외하기

특정 하위 디렉터리의 검색 결과를 무시하고 싶을 때가 있습니다. 예를 들어 모든 숨김 파일과 디렉터리를(-H) 검색하되 .git 디렉터리의 일치 결과는 빼고 싶을 수 있습니다. 이때 -E(또는 --exclude) 옵션을 쓰면 되고, 임의의 glob 패턴을 인수로 받습니다.

> fd -H -E .git …

마운트된 디렉터리를 건너뛸 때도 쓸 수 있습니다.

> fd -E /mnt/external-drive …

… 또는 특정 파일 종류를 건너뛸 때도 쓸 수 있습니다.

> fd -E '*.bak' …

이런 제외 패턴을 영구히 적용하려면 .fdignore 파일을 만들 수 있습니다. .gitignore 파일처럼 동작하지만 fd 전용입니다. 예:

> cat ~/.fdignore
/mnt/external-drive
*.bak

💡 참고 fd는 rg나 ag 같은 다른 프로그램이 쓰는 .ignore 파일도 지원합니다.

이 패턴을 fd가 전역으로 무시하게 하려면 fd의 전역 무시 파일에 넣으면 됩니다. 보통 macOS나 Linux에서는 ~/.config/fd/ignore, Windows에서는 %APPDATA%\fd\ignore에 있습니다.

--hidden 옵션을 쓸 때 .git 디렉터리와 그 내용이 출력에 포함되지 않도록 fd/ignore 파일에 .git/를 넣어 두는 것도 좋습니다.

파일 지우기

검색 패턴에 맞는 모든 파일과 디렉터리를 fd로 지울 수 있습니다. 파일만 지우고 싶다면 --exec-batch/-X 옵션으로 rm을 호출하면 됩니다. 예를 들어 모든 .DS_Store 파일을 재귀적으로 지우려면 다음을 실행합니다.

> fd -H '^\.DS_Store$' -tf -X rm

확신이 없다면 항상 -X rm 없이 먼저 fd를 실행해 보세요. 또는 rm의 "대화형" 옵션을 쓰세요.

> fd -H '^\.DS_Store$' -tf -X rm -i

특정 종류의 디렉터리도 지우고 싶다면 같은 방법을 쓰면 되지만, 디렉터리를 지우려면 rm의 --recursive/-r 플래그를 써야 합니다.

💡 참고 fd … -X rm -r는 경쟁 상태(race condition)를 일으킬 수 있는 상황이 있습니다. …/foo/bar/foo/… 같은 경로가 있고 이름이 foo인 모든 디렉터리를 지우려 하면 바깥쪽 foo 디렉터리가 먼저 지워져 rm 호출에서 (무해한) "'foo/bar/foo': No such file or directory" 오류가 나올 수 있습니다.

명령줄 옵션

다음은 fd -h의 출력입니다. 전체 명령줄 옵션을 보려면 훨씬 자세한 도움말이 나오는 fd --help를 쓰세요.

Usage: fd [OPTIONS] [pattern] [path]...

Arguments:
  [pattern]  the search pattern (a regular expression, unless '--glob' is used; optional)
  [path]...  the root directories for the filesystem search (optional, requires pattern first)

Options:
  -H, --hidden                     Search hidden files and directories
  -I, --no-ignore                  Do not respect .(git|fd)ignore files
  -s, --case-sensitive             Case-sensitive search (default: smart case)
  -i, --ignore-case                Case-insensitive search (default: smart case)
  -g, --glob                       Glob-based search (default: regular expression)
  -a, --absolute-path              Show absolute instead of relative paths
  -l, --list-details               Use a long listing format with file metadata
  -L, --follow                     Follow symbolic links
  -p, --full-path                  Search full abs. path (default: filename only)
  -d, --max-depth <depth>          Set maximum search depth (default: none)
  -E, --exclude <glob>             Exclude entries that match the given glob pattern
  -t, --type <filetype>            Filter by type: file (f), directory (d/dir), symlink (l),
                                   executable (x), empty (e), socket (s), pipe (p), char-device
                                   (c), block-device (b)
  -e, --extension <ext>            Filter by extension
  -S, --size <size>                Limit results based on the size of files
      --changed-within <date|dur>  Filter by file modification time (newer than)
      --changed-before <date|dur>  Filter by file modification time (older than)
  -o, --owner <user:group>         Filter by owning user and/or group
      --format <fmt>               Print results according to template
  -x, --exec <cmd>...              Execute a command for each search result
  -X, --exec-batch <cmd>...        Execute a command with all search results at once
  -c, --color <when>               When to use colors [default: auto] [possible values: auto,
                                   always, never]
      --hyperlink[=<when>]         Add hyperlinks to output paths [default: never] [possible
                                   values: auto, always, never]
      --ignore-contain <name>      Ignore directories containing the named entry
  -h, --help                       Print help (see more with '--help')
  -V, --version                    Print version

옵션은 패턴이나 경로 뒤에 주어도 됩니다.

벤치마크

내 홈 폴더에서 [0-9].jpg로 끝나는 파일을 검색해 보겠습니다. 이 폴더에는 하위 디렉터리가 약 75만 개, 파일이 약 400만 개 들어 있습니다. 평균과 통계 분석에는 hyperfine을 썼습니다. 다음 벤치마크는 디스크 캐시가 미리 채워진 "따뜻한" 상태에서 찍었습니다("차가운" 디스크 캐시의 결과도 같은 경향을 보였습니다).

먼저 find부터 해 봅시다.

Benchmark 1: find ~ -iregex '.*[0-9]\.jpg$'
  Time (mean ± σ):     19.922 s ±  0.109 s
  Range (min … max):   19.765 s … 20.065 s

find는 정규식 검색을 하지 않으면 훨씬 빠릅니다.

Benchmark 2: find ~ -iname '*[0-9].jpg'
  Time (mean ± σ):     11.226 s ±  0.104 s
  Range (min … max):   11.119 s … 11.466 s

이제 같은 것을 fd로 해 봅시다. fd는 기본으로 정규식 검색을 한다는 점에 유의하세요. 공정한 비교를 위해 여기서는 -u/--unrestricted 옵션이 필요합니다. 그렇지 않으면 fd는 숨김 폴더와 무시되는 경로를 훑지 않아도 됩니다(위 내용 참고).

Benchmark 3: fd -u '[0-9]\.jpg$' ~
  Time (mean ± σ):     854.8 ms ±  10.0 ms
  Range (min … max):   839.2 ms … 868.9 ms

이 특정한 예에서 fd는 find -iregex보다 약 23배, find -iname보다 약 13배 빠릅니다. 참고로 두 도구 모두 같은 546개의 파일을 찾았습니다 :smile:.

참고: 이것은 특정 기기에서 한 특정 벤치마크일 뿐입니다. 다양한 테스트를 해 보고 일관된 결과를 얻었지만, 여러분의 환경에서는 다를 수 있습니다. 각자 직접 해 보시길 권합니다. 필요한 스크립트는 이 저장소에 있습니다.

fd의 속도에 대해서는 ripgrep에서도 쓰는 regex와 ignore 크레이트의 공이 큽니다(ripgrep도 한번 살펴보세요!).

문제 해결

fd가 내 파일을 못 찾아요!

fd는 기본으로 숨김 디렉터리와 파일을 무시한다는 점을 기억하세요. .gitignore 파일의 패턴도 무시합니다. 가능한 모든 파일을 빠짐없이 찾으려면 항상 -u/--unrestricted 옵션(또는 숨김과 무시를 함께 켜는 -HI)을 쓰세요.

> fd -u …

또 기본으로 fd는 파일 이름으로만 검색하고 패턴을 전체 경로와 비교하지 않는다는 점도 기억하세요. (find의 -path 옵션처럼) 전체 경로로 검색하려면 --full-path(또는 -p) 옵션을 써야 합니다.

색으로 구분한 출력

fd는 ls처럼 확장자에 따라 파일에 색을 입힐 수 있습니다. 이것이 되려면 환경 변수 LS_COLORS가 설정되어 있어야 합니다. 보통 이 변수의 값은 파일 형식별 색을 정의하는 편리한 설정 형식을 제공하는 dircolors 명령이 정해 둡니다. 대부분의 배포판에서는 LS_COLORS가 이미 설정되어 있습니다. Windows를 쓰거나 대안이나 더 완전한(또는 더 화려한) 변형을 찾고 있다면 여기, 여기, 여기를 보세요.

fd는 NO_COLOR 환경 변수도 따릅니다.

fd가 내 정규식 패턴을 제대로 해석하지 못하는 것 같아요

([], ^, $ 같은) 많은 정규식 특수 문자는 셸에서도 특수 문자입니다. 확실하지 않다면 항상 정규식 패턴을 작은따옴표로 감싸세요.

> fd '^[A-Z][0-9]+$'

패턴이 대시(-)로 시작하면 명령줄 옵션의 끝을 알리는 --를 넣어야 합니다. 그렇지 않으면 패턴이 명령줄 옵션으로 해석됩니다. 대신 하이픈 문자 하나만 있는 문자 클래스를 써도 됩니다.

> fd -- '-pattern'
> fd '[-]pattern'

alias나 셸 함수가 "Command not found"로 나와요

셸 alias와 셸 함수는 fd -x나 fd -X로 하는 명령 실행에 쓸 수 없습니다. zsh에서는 alias -g myalias="…"로 별칭을 전역으로 만들 수 있습니다. bash에서는 export -f my_function으로 자식 프로세스에서 쓸 수 있게 할 수 있습니다. 그래도 fd -x bash -c 'my_function "$1"' bash로 호출해야 합니다. 다른 경우나 다른 셸에서는 (임시) 셸 스크립트를 쓰세요.

-x/-X의 자리 표시자

쓰는 셸에 따라 자리 표시자({}, {/}, {//}, {.}, {/.})를 따옴표로 감싼야 셸이 fd보다 먼저 해석하는 것을 막을 수 있습니다.

다른 메모리 할당기를 미리 올리면 fd가 비정상 종료되어요

배포된 Linux 바이너리는 일부 대상에서 기본으로 켜지는 use-jemalloc 기능을 통해 jemalloc을 씁니다. jemalloc이 포함된 상태에서 다른 할당기를 미리 올리는 것은 지원되지 않습니다. 예를 들어:

> LD_PRELOAD=/usr/bin/mimalloc fd

두 할당기가 할당의 소유자를 서로 다르게 알게 되어 fd가 비정상 종료됩니다. 미리 올린 라이브러리가 첫 할당부터 이미 응답하기 때문에 fd는 이를 감지해 알릴 수 없습니다. 미리 올린 할당기로 실행하려면 jemalloc 없이 빌드하세요.

> cargo build --release --no-default-features

다른 프로그램과의 연동

fzf와 함께 쓰기

fd로 명령줄 퍼지 파인더 fzf의 입력을 만들 수 있습니다.

export FZF_DEFAULT_COMMAND='fd --type file'
export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"

그러면 터미널에서 vim 을 치면 fzf가 열려 fd 결과를 검색할 수 있습니다.

또는 심볼릭 링크를 따라가고 숨김 파일을 포함하되(.git 폴더는 제외하는) 것도 좋을 수 있습니다.

export FZF_DEFAULT_COMMAND='fd --type file --follow --hidden --exclude .git'

fzf 안에서 fd의 색 출력을 쓰도록 설정할 수도 있습니다.

export FZF_DEFAULT_COMMAND="fd --type file --color=always"
export FZF_DEFAULT_OPTS="--ansi"

자세한 내용은 fzf README의 팁 절을 보세요.

rofi와 함께 쓰기

rofi는 stdin을 읽어 메뉴를 만들 수 있는 그래픽 실행 메뉴 애플리케이션입니다. fd의 출력을 rofi의 -dmenu 모드로 넘기면 퍼지 검색이 되는 파일과 디렉터리 목록을 만들 수 있습니다.

예시

$HOME 디렉터리 아래의 PDF 파일로 대소문자를 구분하지 않는 검색 가능한 다중 선택 목록을 만들고, 선택한 파일을 설정된 PDF 뷰어로 엽니다. 모든 파일 형식을 나열하려면 -e pdf 인수를 빼세요.

fd --type f -e pdf . $HOME | rofi -keep-right -dmenu -i -p FILES -multi-select | xargs -I {} xdg-open {}

rofi가 보여 주는 목록을 바꾸려면 fd 명령에 인수를 추가하고, rofi의 검색 동작을 바꾸려면 rofi 명령에 인수를 추가하세요.

emacs와 함께 쓰기

emacs 패키지 find-file-in-project가 fd로 파일을 찾을 수 있습니다.

find-file-in-project를 설치한 뒤 ~/.emacs나 ~/.emacs.d/init.el 파일에 (setq ffip-use-rust-fd t) 줄을 추가하세요.

emacs에서 M-x find-file-in-project-by-selected를 실행하면 일치하는 파일을 찾습니다. 또는 M-x find-file-in-project를 실행하면 프로젝트의 모든 파일을 나열합니다.

출력을 트리로 보여 주기

fd의 출력을 파일 트리 모양으로 만들려면 tree 명령의 --fromfile을 쓰면 됩니다.

❯ fd | tree --fromfile

tree는 기본으로 어떤 파일도 무시하지 않고 fd만큼 풍부한 출력 제어 옵션도 없으므로, 이렇게 쓰는 것이 tree를 단독으로 실행하는 것보다 더 유용할 수 있습니다.

❯ fd --extension rs | tree --fromfile
.
├── build.rs
└── src
    ├── app.rs
    └── error.rs

bash 같은 셸에서는 별칭을 간단히 만들 수 있습니다.

❯ alias as-tree='tree --fromfile'

xargs나 parallel과 함께 쓰기

fd에는 -x/--exec와 -X/--exec-batch 옵션으로 하는 내장 명령 실행 기능이 있다는 점을 기억하세요. 원한다면 여전히 xargs와 조합해 쓸 수 있습니다.

> fd -0 -e rs | xargs -0 wc -l

여기서 -0 옵션은 fd가 검색 결과를 (줄바꿈 대신) NULL 문자로 구분하라는 뜻입니다. 같은 방식으로 xargs의 -0 옵션은 입력을 그렇게 읽라는 뜻입니다.

설치

패키지 현황

Ubuntu

... 그리고 다른 Debian 계열 Linux 배포판.

Ubuntu 19.04(Disco Dingo) 이상이라면 공식으로 관리되는 패키지를 설치할 수 있습니다.

apt install fd-find

바이너리 이름 fd를 다른 패키지가 이미 쓰고 있어서 바이너리 이름이 fdfind라는 점에 유의하세요. 설치 후 이 문서와 같은 방식으로 fd를 쓰려면 ln -s $(which fdfind) ~/.local/bin/fd 명령으로 fd 링크를 추가하기를 권장합니다. $HOME/.local/bin이 $PATH에 있는지 확인하세요.

더 오래된 Ubuntu를 쓴다면 릴리스 페이지에서 최신 .deb 패키지를 내려받아 다음으로 설치할 수 있습니다.

dpkg -i fd_9.0.0_amd64.deb # 버전 번호와 아키텍처는 받은 파일에 맞게 바꾸세요

이 프로젝트의 릴리스 페이지에 있는 .deb 패키지는 여전히 실행 파일 이름을 fd로 합니다.

Debian

Debian Buster 이상이라면 공식으로 관리되는 Debian 패키지를 설치할 수 있습니다.

apt-get install fd-find

바이너리 이름 fd를 다른 패키지가 이미 쓰고 있어서 바이너리 이름이 fdfind라는 점에 유의하세요. 설치 후 이 문서와 같은 방식으로 fd를 쓰려면 ln -s $(which fdfind) ~/.local/bin/fd 명령으로 fd 링크를 추가하기를 권장합니다. $HOME/.local/bin이 $PATH에 있는지 확인하세요.

이 프로젝트의 릴리스 페이지에 있는 .deb 패키지는 여전히 실행 파일 이름을 fd로 합니다.

Fedora

Fedora 28부터는 공식 패키지 저장소에서 fd를 설치할 수 있습니다.

dnf install fd-find

Alpine Linux

알맞은 저장소를 켜 두었다면 공식 저장소의 fd 패키지를 설치할 수 있습니다.

apk add fd

Arch Linux

공식 저장소의 fd 패키지를 설치할 수 있습니다.

pacman -S fd

AUR에서 설치할 수도 있습니다.

Gentoo Linux

공식 저장소의 fd ebuild를 쓸 수 있습니다.

emerge -av fd

openSUSE Linux

공식 저장소의 fd 패키지를 설치할 수 있습니다.

zypper in fd

Void Linux

xbps-install으로 fd를 설치할 수 있습니다.

xbps-install -S fd

ALT Linux

공식 저장소의 fd 패키지를 설치할 수 있습니다.

apt-get install fd

Solus

공식 저장소의 fd 패키지를 설치할 수 있습니다.

eopkg install fd

RedHat Enterprise Linux(RHEL) 8/9/10, Almalinux 8/9/10, EuroLinux 8/9, Rocky Linux 8/9/10

Fedora Copr에서 fd 패키지를 설치할 수 있습니다.

dnf copr enable tkbcopr/fd
dnf install fd

jemalloc 대신 더 느린 malloc을 쓰는 다른 버전도 EPEL8/9 저장소에서 fd-find라는 이름의 패키지로 받을 수 있습니다.

macOS

Homebrew로 fd를 설치할 수 있습니다.

brew install fd

… 또는 MacPorts로:

port install fd

Windows

릴리스 페이지에서 미리 빌드된 바이너리를 내려받을 수 있습니다.

또는 Scoop으로 fd를 설치할 수 있습니다.

scoop install fd

또는 Chocolatey로:

choco install fd

또는 Winget으로:

winget install sharkdp.fd

GuixOS

공식 저장소의 fd 패키지를 설치할 수 있습니다.

guix install fd

Mise

mise로 다음과 같은 명령으로 fd를 설치할 수 있습니다.

mise use -g fd@latest

NixOS / Nix

Nix 패키지 관리자로 fd를 설치할 수 있습니다.

nix-env -i fd

Flox

Flox로 fd를 Flox 환경에 설치할 수 있습니다.

flox install fd

FreeBSD

공식 저장소의 fd-find 패키지를 설치할 수 있습니다.

pkg install fd-find

npm

Linux와 macOS에서는 fd-find 패키지를 설치할 수 있습니다.

npm install -g fd-find

소스에서 빌드

Rust의 패키지 관리자 cargo로 fd를 설치할 수 있습니다.

cargo install fd-find

Rust 버전 1.90.0 이상이 필요합니다.

빌드에는 make도 필요합니다.

미리 빌드된 바이너리

릴리스 페이지에는 Linux, macOS, Windows용 미리 빌드된 바이너리가 들어 있습니다. 정적 링크 바이너리도 있습니다. 파일 이름에 musl이 들어 있는 압축 파일을 찾으세요.

개발

git clone https://github.com/sharkdp/fd

# Build
cd fd
cargo build

# Run unit tests and integration tests
cargo test

# Install
cargo install --path .

자동 완성

릴리스 압축 파일에서

미리 만든 자동 완성 파일은 릴리스 페이지의 릴리스 압축 파일(.tar.gz/.zip) 안 autocomplete 디렉터리에 들어 있습니다. 이 자동 완성을 쓰는 방법은 다음과 같습니다.

  • bash: fd.bash 파일을 ~/.bashrc에서 불러오거나(source), 자동으로 불러오는 디렉터리에 둔다.
  • zsh: _fd를 fpath에 있는 디렉터리(예: ~/.zfunc)로 옮긴다.
  • fish: fd.fish를 ~/.config/fish/completions/에 복사한다.
  • powershell: 프로필 스크립트 중 하나에서 _fd.ps1을 불러온다(source).

fd에서 직접 만들기

fd --gen-completions 로 자동 완성을 직접 만들 수도 있습니다.

# Bash
fd --gen-completions bash > ~/.local/share/bash-completion/completions/fd

# Zsh (ensure ~/.zfunc is in your fpath)
fd --gen-completions zsh > ~/.zfunc/_fd

# Fish
fd --gen-completions fish > ~/.config/fish/completions/fd.fish

# PowerShell
fd --gen-completions powershell >> $PROFILE

관리자

라이선스

fd는 MIT 라이선스와 Apache License 2.0 두 가지 조건 모두로 배포됩니다.

라이선스 세부 내용은 LICENSE-APACHE와 LICENSE-MIT 파일을 보세요.

저장소

sharkdp/fd

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0