fzf

KO | EN

gitlite — search

#python #llm #golang #go #android #machine-learning #linux #docker #nodejs #java #windows #security #mcp #open-source

(★ 82,545)

:cherry_blossom: A command-line fuzzy finder

fzf 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[SUMMARY_KO]
:cherry_blossom: 명령줄 퍼지 파인더(fuzzy finder)

[FULL_CONTENT]
<div align="center">
  <img src="https://raw.githubusercontent.com/junegunn/i/master/fzf-color.png" alt="fzf - a command-line fuzzy finder">
  <a href="https://github.com/junegunn/fzf/actions"><img src="https://github.com/junegunn/fzf/actions/workflows/linux.yml/badge.svg?branch=master" alt="Build Status"></a>
  <a href="http://github.com/junegunn/fzf/releases"><img src="https://img.shields.io/github/v/tag/junegunn/fzf" alt="Version"></a>
  <a href="https://github.com/junegunn/fzf?tab=MIT-1-ov-file#readme"><img src="https://img.shields.io/github/license/junegunn/fzf" alt="License"></a>
  <a href="https://github.com/junegunn/fzf/graphs/contributors"><img src="https://img.shields.io/github/contributors/junegunn/fzf" alt="Contributors"></a>
  <a href="https://github.com/sponsors/junegunn"><img src="https://img.shields.io/github/sponsors/junegunn" alt="Sponsors"></a>
  <a href="https://github.com/junegunn/fzf/stargazers"><img src="https://img.shields.io/github/stars/junegunn/fzf?style=flat" alt="Stars"></a>
</div>

---

<kbd align="center">
  <br/>
  <a href="https://commitgoods.com/collections/fzf"><img src="https://junegunn.github.io/fzf/images/fzf-mugs.jpg" width="80%" alt="fzf merch"></a>
  <br/>
  <br/>
  fzf에 대한 애정을 표현해보세요 -- 티셔츠, 머그컵, 스티커를 지금 만나보실 수 있습니다!
  <br/>
  <br/>
  <a href="https://commitgoods.com/collections/fzf">commitgoods.com/collections/fzf</a>
  <br/>
  <br/>
</kbd>

---

fzf는 범용 명령줄 퍼지 파인더이자 대화형 터미널 툴킷입니다.

파일을 선택하든, 명령어 기록을 탐색하든, 데이터를 미리 보든,
퍼지 매칭으로 복잡한 데이터셋을 탐색하든, 또는 커스텀 메뉴와 워크플로우를 생성하든,
fzf는 셸 스크립트를 풍부한 터미널 애플리케이션으로 탈바꿈시킬 구성 요소를 제공합니다.

주요 특징
----------

- **이식성(Portable)** // 간편한 설치를 위해 단일 바이너리로 배포됩니다.
- **빠른 속도(Fast)** // 수백만 개의 항목을 밀리초 단위로 처리하도록 최적화되어 있습니다.
- **프로그래밍 가능(Programmable)** // 커스텀 터미널 인터페이스와 워크플로우를 구축하기 위한 이벤트 기반 아키텍처를 제공합니다.
- **기본 탑재(Batteries-included)** // Bash, Zsh, Fish, Nushell, Vim, Neovim 통합 기능을 기본으로 제공합니다.

목차
-----------------

* [설치](#installation)
    * [Homebrew 사용](#using-homebrew)
    * [Mise 사용](#using-mise)
    * [Linux 패키지](#linux-packages)
    * [Windows 패키지](#windows-packages)
    * [git 사용](#using-git)
    * [바이낸리 릴리즈](#binary-releases)
    * [셸 통합 설정](#setting-up-shell-integration)
    * [Vim/Neovim 플러그인](#vimneovim-plugin)
* [fzf 업그레이드](#upgrading-fzf)
* [fzf 빌드](#building-fzf)
* [사용법](#usage)
    * [파인더 사용하기](#using-the-finder)
    * [디스플레이 모드](#display-modes)
        * [`--height` 모드](#--height-mode)
        * [`--popup` 모드](#--popup-mode)
    * [검색 문법](#search-syntax)
    * [환경 변수](#environment-variables)
    * [모양 커스텀하기](#customizing-the-look)
    * [옵션](#options)
    * [데모](#demo)
* [예제](#examples)
* [명령줄용 키 바인딩](#key-bindings-for-command-line)
* [퍼지 자동 완성](#fuzzy-completion)
    * [파일 및 디렉터리](#files-and-directories)
    * [프로세스 ID](#process-ids)
    * [호스트 이름](#host-names)
    * [환경 변수 / 별칭(Aliases)](#environment-variables--aliases)
    * [bash 및 zsh용 퍼지 자동 완성 커스텀하기](#customizing-fuzzy-completion-for-bash-and-zsh)
        * [완성을 위한 fzf 옵션 커스텀하기](#customizing-fzf-options-for-completion)
        * [경로 및 디렉터리 완성 소스 커스텀하기](#customizing-completion-source-for-paths-and-directories)
        * [지원되는 명령어 (bash)](#supported-commands-bash)
        * [커스텀 퍼지 자동 완성](#custom-fuzzy-completion)
    * [fish용 퍼지 자동 완성](#fuzzy-completion-for-fish)
    * [Nushell용 퍼지 자동 완성](#fuzzy-completion-for-nushell)
* [Vim 플러그인](#vim-plugin)
* [고급 주제](#advanced-topics)
    * [다양한 유형의 입력에 맞게 커스텀하기](#customizing-for-different-types-of-input)
    * [성능](#performance)
    * [외부 프로그램 실행](#executing-external-programs)
    * [다른 프로세스로 전환하기](#turning-into-a-different-process)
    * [후보 목록 새로고침](#reloading-the-candidate-list)
        * [1. CTRL-R을 눌러 프로세스 목록 업데이트하기](#1-update-the-list-of-processes-by-pressing-ctrl-r)
        * [2. CTRL-D 또는 CTRL-F를 눌러 소스 전환하기](#2-switch-between-sources-by-pressing-ctrl-d-or-ctrl-f)
        * [3. 대화형 ripgrep 통합](#3-interactive-ripgrep-integration)
    * [미리보기 창](#preview-window)
    * [이미지 미리보기](#previewing-an-image)
* [팁](#tips)
    * [`.gitignore` 준수하기](#respecting-gitignore)
    * [Fish 셸](#fish-shell)
    * [fzf 테마 플레이그라운드](#fzf-theme-playground)
* [관련 프로젝트](#related-projects)
* [라이선스](#license)
* [굿즈](#goods)
* [후원자 :heart:](#sponsors-heart)

설치
------------

### Homebrew 사용

[Homebrew](https://brew.sh/)(macOS 또는 Linux)를 사용하여 fzf를 설치할 수 있습니다.

```sh
brew install fzf
```

> [!IMPORTANT]
> 셸 통합(키 바인딩 및 퍼지 자동 완성)을 설정하려면,
> [아래 안내](#setting-up-shell-integration)를 참고하세요.

fzf는 [MacPorts][portfile]를 통해서도 설치할 수 있습니다: `sudo port install fzf`

[portfile]: https://github.com/macports/macports-ports/blob/master/sysutils/fzf/Portfile

### Mise 사용

[mise](https://github.com/jdx/mise)를 사용하여 fzf를 설치할 수 있습니다.

```sh
mise use -g fzf@latest
```

### Linux 패키지

| 패키지 매니저 | Linux 배포판            | 명령어                             |
| ------------- | ----------------------- | ---------------------------------- |
| APK           | Alpine Linux            | `sudo apk add fzf`                 |
| APT           | Debian 9+/Ubuntu 19.10+ | `sudo apt install fzf`             |
| Conda         |                         | `conda install -c conda-forge fzf` |
| DNF           | Fedora                  | `sudo dnf install fzf`             |
| Nix           | NixOS 등                | `nix-env -iA nixpkgs.fzf`          |
| Pacman        | Arch Linux              | `sudo pacman -S fzf`               |
| pkg           | FreeBSD                 | `pkg install fzf`                  |
| pkgin         | NetBSD                  | `pkgin install fzf`                |
| pkg_add       | OpenBSD                 | `pkg_add fzf`                      |
| Portage       | Gentoo                  | `emerge --ask app-shells/fzf`      |
| Spack         |                         | `spack install fzf`                |
| XBPS          | Void Linux              | `sudo xbps-install -S fzf`         |
| Zypper        | openSUSE                | `sudo zypper install fzf`          |

> [!IMPORTANT]
> 셸 통합(키 바인딩 및 퍼지 자동 완성)을 설정하려면,
> [아래 안내](#setting-up-shell-integration)를 참고하세요.

[![패키지 상태](https://repology.org/badge/vertical-allrepos/fzf.svg?columns=3)](https://repology.org/project/fzf/versions)

### Windows 패키지

Windows에서는 [Chocolatey][choco], [Scoop][scoop],
[Winget][winget], [MSYS2][msys2]를 통해 fzf를 사용할 수 있습니다:

| 패키지 매니저 | 명령어                                |
| ------------- | ------------------------------------- |
| Chocolatey    | `choco install fzf`                   |
| Scoop         | `scoop install fzf`                   |
| Winget        | `winget install fzf`                  |
| MSYS2 (pacman)| `pacman -S $MINGW_PACKAGE_PREFIX-fzf` |

[choco]: https://chocolatey.org/packages/fzf
[scoop]: https://github.com/ScoopInstaller/Main/blob/master/bucket/fzf.json
[winget]: https://github.com/microsoft/winget-pkgs/tree/master/manifests/j/junegunn/fzf
[msys2]: https://packages.msys2.org/base/mingw-w64-fzf

### git 사용

또는 이 저장소를 임의의 디렉터리에 "git clone"한 뒤
[install](https://github.com/junegunn/fzf/blob/master/install) 스크립트를 실행할 수 있습니다.

```sh
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install
```

설치 스크립트는 셸 설정 파일에 줄을 추가하여 `$PATH`를 수정하고 셸 통합을 설정합니다.

### 바이너리 릴리즈

릴리즈 페이지에서 공식 fzf 바이너리를 다운로드할 수 있습니다.

* https://github.com/junegunn/fzf/releases

### 셸 통합 설정

셸 설정 파일에 다음 줄을 추가하세요.

* bash
  ```sh
  # fzf 키 바인딩 및 퍼지 자동 완성 설정
  eval "$(fzf --bash)"
  ```
* zsh
  ```sh
  # fzf 키 바인딩 및 퍼지 자동 완성 설정
  source <(fzf --zsh)
  ```
* fish
  ```fish
  # fzf 키 바인딩 설정
  fzf --fish | source
  ```
* Nushell -- Nushell은 `source`로의 파이핑을 지원하지 않으므로, 설치 스크립트가 자동 로드 디렉터리에 파일을 생성합니다. 설치 스크립트를 사용하지 않은 경우 수동으로 설정할 수 있습니다:
  ```nu
  # 통합 스크립트 생성
  mkdir ($nu.default-config-dir | path join "autoload")
  fzf --nushell | save -f ($nu.default-config-dir | path join "autoload" "_fzf_integration.nu")
  ```

> [!NOTE]
> `--bash`, `--zsh`, `--fish`, `--nushell` 옵션은 fzf 최신 버전에서만 사용할 수 있습니다. 이전 버전을 사용 중이거나 더 세밀한 제어를 원하시는 경우, [/shell](/shell) 디렉터리에 있는 개별 스크립트 파일을 소스할 수 있습니다. 파일의 위치는 사용하는 패키지 매니저에 따라 다를 수 있습니다.
> 자세한 내용은 패키지 문서를 참조하세요.
> (예: `apt show fzf`)

> [!TIP]
> 스크립트를 로드할 때 해당하는 `*_COMMAND` 변수를 빈 문자열로 설정하여 CTRL-T, CTRL-R, ALT-C 바인딩을 비활성화할 수 있습니다. 예를 들어 CTRL-R과 ALT-C를 비활성화하려면:
>
> * bash: `FZF_CTRL_R_COMMAND= FZF_ALT_C_COMMAND= eval "$(fzf --bash)"`
> * zsh: `FZF_CTRL_R_COMMAND= FZF_ALT_C_COMMAND= source <(fzf --zsh)`
> * fish: `fzf --fish | FZF_CTRL_R_COMMAND= FZF_ALT_C_COMMAND= source`
> * nushell: `env.nu`에 다음을 추가하세요:
>   `$env.FZF_CTRL_R_COMMAND = ""; $env.FZF_ALT_C_COMMAND = ""`
>
> 스크립트를 소스한 이후에 변수를 설정하면 아무런 효과가 없습니다.

### Vim/Neovim 플러그인

[vim-plug](https://github.com/junegunn/vim-plug)를 사용하는 경우, Vim 설정 파일에 다음을 추가하세요:

```vim
Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
Plug 'junegunn/fzf.vim'
```

* `junegunn/fzf`는 기본 라이브러리 함수를 제공합니다.
    * `fzf#install()`은 최신 바이너리를 보장합니다.
* `junegunn/fzf.vim`은 다양한 유용한 명령어를 제공하는 [별도의 프로젝트](https://github.com/junegunn/fzf.vim)입니다.

Vim 통합에 대해 더 알아보려면 [README-VIM.md](README-VIM.md)를 참고하세요.

> [!TIP]
> Neovim을 사용하며 Lua 기반 플러그인을 선호한다면
> [fzf-lua](https://github.com/ibhagwan/fzf-lua)를 확인해보세요.

fzf 업그레이드
-------------

fzf는 활발히 개발되고 있으며, 가끔 업그레이드하는 것이 좋습니다. 사용한 설치 방법에 따라 아래 안내를 따르세요.

- git: `cd ~/.fzf && git pull && ./install`
- brew: `brew update; brew upgrade fzf`
- macports: `sudo port upgrade fzf`
- chocolatey: `choco upgrade fzf`
- vim-plug: `:PlugUpdate fzf`

fzf 빌드
------------

[BUILD.md](BUILD.md)를 참고하세요.

사용법
-----

fzf는 대화형 파인더를 실행하고, STDIN에서 목록을 읽은 후, 선택된 항목을 STDOUT으로 출력합니다.

```sh
find * -type f | fzf > selected
```

STDIN 파이프가 없는 경우, fzf는 현재 디렉터리 아래의 파일 시스템을 순회하여 파일 목록을 가져옵니다.

```sh
vim $(fzf)
```

> [!NOTE]
> 기본 동작을 재정의할 수 있습니다.
> * 원하는 목록을 생성하는 명령어로 `$FZF_DEFAULT_COMMAND`를 설정하거나
> * `$FZF_DEFAULT_OPTS`에 `--walker`, `--walker-root`, `--walker-skip` 옵션을 설정합니다.

> [!WARNING]
> `xargs`를 사용하는 것이 더 안정적인 방법이지만, 이해하기 쉽도록 위와 같이 제시했습니다.
> ```sh
> fzf --print0 | xargs -0 -o vim
> ```

> [!TIP]
> fzf에는 스스로를 다른 프로세스로 전환하는 기능도 있습니다.
>
> ```sh
> fzf --bind 'enter:become(vim {})'
> ```
>
> *자세한 내용은 [다른 프로세스로 전환하기](#turning-into-different-process)를 참고하세요.*

### 파인더 사용하기

- 커서를 위아래로 움직이려면 `CTRL-K` / `CTRL-J` (또는 `CTRL-P` / `CTRL-N`)
- 항목을 선택하려면 `Enter`, 종료하려면 `CTRL-C` / `CTRL-G` / `ESC`
- 다중 선택 모드(`-m`)에서 여러 항목을 표시하려면 `TAB` 및 `Shift-TAB`
- Emacs 스타일 키 바인딩
- 마우스: 스크롤, 클릭, 더블 클릭; 다중 선택 모드에서 시프트 클릭 및 시프트 스크롤

### 디스플레이 모드

fzf는 기본적으로 전체 화면 모드로 실행되지만, 다른 디스플레이 모드도 존재합니다.

#### `--height` 모드

`--height HEIGHT[%]`를 사용하면 fzf가 지정된 높이로 커서 아래에 나타납니다.

```sh
fzf --height 40%
```

`reverse` 레이아웃과 `--border` 옵션이 이 옵션과 잘 어울립니다.

```sh
fzf --height 40% --layout reverse --border
```

높이 앞에 `~`를 붙이면 최대 높이가 설정됩니다.

```sh
# 목록을 표시하는 데 필요한 최소한의 줄 수만 사용합니다.
seq 3 | fzf --height ~100%
seq 3000 | fzf --height ~100%
```

높이 값은 음수가 될 수도 있습니다.

```sh
# 화면 높이 - 3
fzf --height -3
```

#### `--popup` 모드

`--popup` 옵션을 사용하면 fzf가 팝업 창에서 실행됩니다.
(tmux 3.3+ 또는 Zellij 0.44+ 필요)

```sh
# --popup [center|top|bottom|left|right][,SIZE[%]][,SIZE[%][,border-native]]

fzf --popup center         # 중앙, 너비 및 높이 50%
fzf --popup 80%            # 중앙, 너비 및 높이 80%
fzf --popup 100%,50%       # 중앙, 너비 100%, 높이 50%
fzf --popup left,40%       # 왼쪽, 너비 40%
fzf --popup left,40%,90%   # 왼쪽, 너비 40%, 높이 90%
fzf --popup top,40%        # 위쪽, 높이 40%
fzf --popup bottom,80%,40% # 아래쪽, 너비 80%, 높이 40%
```

tmux나 Zellij 환경이 아닌 경우 `--popup`은 조용히 무시됩니다.

> [!NOTE]
> 팝업을 지원하지 않는 구버전 tmux를 사용 중이거나 일반 tmux 창에서 fzf를 열고 싶다면
> [fzf-tmux](bin/fzf-tmux) 스크립트를 확인하세요.

> [!TIP]
> 이 옵션들을 `$FZF_DEFAULT_OPTS`에 추가하여 기본적으로 적용되도록 할 수 있습니다. 예를 들어:
>
> ```sh
> # tmux나 Zellij 환경인 경우 팝업으로 열고, 아니면 --height 모드 사용
> export FZF_DEFAULT_OPTS='--height 40% --popup bottom,40% --layout reverse --border top'
> ```

### 검색 문법

별도로 지정하지 않는 한, fzf는 공백으로 구분된 여러 검색어를 입력할 수 있는 "확장 검색 모드(extended-search mode)"로 시작합니다. 예: `^music .mp3$ sbtrkt !fire`

| 토큰      | 일치 유형                              | 설명                                         |
| --------- | -------------------------------------- | -------------------------------------------- |
| `sbtrkt`  | 퍼지 매치                              | `sbtrkt`와 일치하는 항목                     |
| `'wild`   | 정확히 일치 (따옴표 사용)              | `wild`가 포함된 항목                         |
| `'wild'`  | 단어 경계 정확히 일치 (양끝 따옴표)    | 단어 경계에 `wild`가 포함된 항목             |
| `^music`  | 접두사 정확히 일치                     | `music`으로 시작하는 항목                    |
| `.mp3$`   | 접미사 정확히 일치                     | `.mp3`로 끝나는 항목                         |
| `!fire`   | 제외 정확히 일치 (반전)                | `fire가` 포함되지 않은 항목                  |
| `!^music` | 제외 접두사 정확히 일치                | `music`으로 시작하지 않는 항목               |
| `!.mp3$`  | 제외 접미사 정확히 일치                | `.mp3`로 끝나지 않는 항목                    |

퍼지 매칭을 선호하지 않고 모든 단어에 "따옴표"를 붙이기 싫다면, `-e` 또는 `--exact` 옵션으로 fzf를 시작하세요. `--exact`가 설정된 경우 `'` 접두사는 해당 검색어의 따옴표 효과를 "해제"합니다.

단일 바(`|`) 문자 검색어는 OR 연산자로 작동합니다. 예를 들어, 다음 쿼리는 `core`로 시작하고 `go`, `rb`, `py` 중 하나로 끝나는 항목과 일치합니다.

```
^core go$ | rb$ | py$
```

### 환경 변수

- `FZF_DEFAULT_COMMAND`
    - 입력이 tty일 때 사용할 기본 명령어
    - 예: `export FZF_DEFAULT_COMMAND='fd --type f'`
- `FZF_DEFAULT_OPTS`
    - 기본 옵션
    - 예: `export FZF_DEFAULT_OPTS="--layout=reverse --inline-info"`
- `FZF_DEFAULT_OPTS_FILE`
    - 파일로 기본 옵션을 관리하려는 경우, 이 변수를 해당 파일의 경로로 설정하세요.
    - 예: `export FZF_DEFAULT_OPTS_FILE=~/.fzfrc`

> [!WARNING]
> 요구 사항의 미세한 차이로 인해 셸 통합에서는 `FZF_DEFAULT_COMMAND`가 사용되지 않습니다.
>
> * `CTRL-T`는 `$FZF_CTRL_T_COMMAND`를 실행하여 파일 및 디렉터리 목록을 가져옵니다.
> * `ALT-C`는 `$FZF_ALT_C_COMMAND`를 실행하여 디렉터리 목록을 가져옵니다.
> * `vim ~/**<tab>`은 접두사(`~/`)를 첫 번째 인수로 하여 `fzf_compgen_path()`를 실행합니다.
> * `cd foo**<tab>`은 접두사(`foo`)를 첫 번째 인수로 하여 `fzf_compgen_dir()`을 실행합니다.
>
> 사용 가능한 옵션은 본 문서의 후반부에 설명되어 있습니다.

### 모양 커스텀하기

fzf의 사용자 인터페이스는 수많은 설정 옵션을 통해 완전히 커스텀할 수 있습니다. 빠른 설정을 원한다면 `--style` 옵션을 사용하여 `default`, `full`, `minimal` 중 하나의 스타일 프리셋으로 시작할 수 있습니다.

```sh
fzf --style full \
    --preview 'fzf-preview.sh {}' --bind 'focus:transform-header:file --brief {}'
```

`full` 프리셋을 기반으로 한 예제입니다:

```sh
git ls-files | fzf --style full \
    --border --padding 1,2 \
    --border-label ' Demo ' --input-label ' Input ' --header-label ' File Type ' \
    --preview 'fzf-preview.sh {}' \
    --bind 'result:transform-list-label:
        if [[ -z $FZF_QUERY ]]; then
          echo " $FZF_MATCH_COUNT items "
        else
          echo " $FZF_MATCH_COUNT matches for [$FZF_QUERY] "
        fi
        ' \
    --bind 'focus:transform-preview-label:[[ -n {} ]] && printf " Previewing [%s] " {}' \
    --bind 'focus:+transform-header:file --brief {} || echo "No file selected"' \
    --bind 'ctrl-r:change-list-label( Reloading the list )+reload(sleep 2; git ls-files)' \
    --color 'border:#aaaaaa,label:#cccccc' \
    --color 'preview-border:#9999cc,preview-label:#ccccff' \
    --color 'list-border:#669966,list-label:#99cc99' \
    --color 'input-border:#996666,input-label:#ffcccc' \
    --color 'header-border:#6699cc,header-label:#99ccff'
```

</details>

### 옵션

전체 옵션 목록은 맨 페이지(`fzf --man` 또는 `man fzf`)를 참조하세요.

### 데모
동영상 시청을 통해 배우는 편이라면, `fzf` 기능을 살펴볼 수 있는 [@samoshkin](https://github.com/samoshkin)의 스크린캐스트를 확인해보세요.

예제
--------

* [예제 위키 페이지](https://github.com/junegunn/fzf/wiki/examples)
    * *면책 조항: 이 페이지의 예제들은 커뮤니티에 의해 유지보수되며 철저히 테스트되지 않았을 수 있습니다.*
* [고급 fzf 예제](https://github.com/junegunn/fzf/blob/master/ADVANCED.md)

명령줄용 키 바인딩
-----------------------------

[셸 통합 설정](#setting-up-shell-integration)을 통해 bash, zsh, fish, Nushell에서 다음 키 바인딩을 사용할 수 있습니다.

- `CTRL-T` - 선택한 파일과 디렉터리를 명령줄에 붙여넣습니다.
    - 목록은 `--walker file,dir,follow,hidden` 옵션을 사용하여 생성됩니다.
        - 원하는 목록을 생성하는 커스텀 명령어로 `FZF_CTRL_T_COMMAND`를 설정하여 동작을 재정의할 수 있습니다.
        - 또는 `FZF_CTRL_T_OPTS`에 `--walker*` 옵션을 설정할 수 있습니다.
    - fzf에 추가 옵션을 전달하려면 `FZF_CTRL_T_OPTS`를 설정하세요.
      ```sh
      # bat을 사용하여 파일 내용 미리보기 (https://github.com/sharkdp/bat)
      export FZF_CTRL_T_OPTS="
        --walker-skip .git,node_modules,target
        --preview 'bat -n --color=always {}'
        --bind 'ctrl-/:change-preview-window(down|hidden|)'"
      ```
    - 스크립트를 소스할 때 `FZF_CTRL_T_COMMAND`를 빈 문자열로 설정하여 비활성화할 수 있습니다.
- `CTRL-R` - 기록에서 선택한 명령어를 명령줄에 붙여넣습니다.
    - `TAB`으로 여러 명령어를 선택하세요.
    - 연대순으로 명령어를 보고 싶다면, 관련성순 정렬을 토글하는 `CTRL-R`을 다시 누르세요.
    - 매치 항목의 주변 항목을 볼 수 있는 "raw" 모드를 토글하려면 `ALT-R`을 누르세요. 이 모드에서는 `CTRL-N`과 `CTRL-P`를 눌러 일치하는 항목 간에만 이동할 수 있습니다.
    - 줄 바꿈을 토글하려면 `CTRL-/` 또는 `ALT-/`를 누르세요.
    - 선택한 명령어를 삭제하려면 `SHIFT-DELETE`를 누르세요 (bash 및 fish).
    - Fish 셸 전용:
      - 선택한 명령어를 재포맷하고 삽입하려면 `ALT-ENTER`를 누르세요.
      - 명령어 접두사(타임스탬프, 날짜/시간, 없음)를 순환하려면 `ALT-T`를 누르세요.
    - fzf에 추가 옵션을 전달하려면 `FZF_CTRL_R_OPTS`를 설정하세요.
      ```sh
      # pbcopy를 사용하여 명령어를 클립보드에 복사하는 CTRL-Y
      export FZF_CTRL_R_OPTS="
        --bind 'ctrl-y:execute-silent(echo -n {2..} | pbcopy)+abort'
        --color header:italic
        --header 'Press CTRL-Y to copy command into clipboard'"
      ```
      ```fish
      # Fish 셸: 날짜/시간을 기본 접두사로 설정
      set -gx FZF_CTRL_R_OPTS "--with-nth 1,3.. --bind 'alt-t:change-with-nth(2..|3..|1,3..)'"

# 또는 기본적으로 접두사를 표시하지 않음
      set -gx FZF_CTRL_R_OPTS "--with-nth 3.. --bind 'alt-t:change-with-nth(2..|1,3..|3..)'"
      ```
    - 스크립트를 소스할 때 `FZF_CTRL_R_COMMAND`를 빈 문자열로 설정하여 비활성화할 수 있습니다.
    - 비어 있지 않은 `FZF_CTRL_R_COMMAND`를 통한 커스텀 재정의는 아직 지원되지 않으며 경고가 발생합니다.
- `ALT-C` - 선택한 디렉터리로 cd 이동
    - 목록은 `--walker dir,follow,hidden` 옵션을 사용하여 생성됩니다.
    - 기본 명령어를 재정의하려면 `FZF_ALT_C_COMMAND`를 설정하세요.
        - 또는 `FZF_ALT_C_OPTS`에 `--walker-*` 옵션을 설정할 수 있습니다.
    - fzf에 추가 옵션을 전달하려면 `FZF_ALT_C_OPTS`를 설정하세요.
      ```sh
      # 미리보기 창에 트리 구조 출력
      export FZF_ALT_C_OPTS="
        --walker-skip .git,node_modules,target
        --preview 'tree -C {}'"
      ```
    - 스크립트를 소스할 때 `FZF_ALT_C_COMMAND`를 빈 문자열로 설정하여 비활성화할 수 있습니다.

이러한 바인딩의 디스플레이 모드는 `FZF_{CTRL_T,CTRL_R,ALT_C}_OPTS`를 통해 개별적으로 설정하거나 `FZF_DEFAULT_OPTS`를 통해 전역적으로 설정할 수 있습니다.
(예: `FZF_CTRL_R_OPTS='--popup bottom,60% --height 60% --border top'`)

더 많은 팁은 [위키 페이지](https://github.com/junegunn/fzf/wiki/Configuring-shell-key-bindings)에서 확인하실 수 있습니다.

퍼지 자동 완성
----------------

셸 통합은 또한 bash, zsh, fish, Nushell을 위한 퍼지 자동 완성을 제공합니다.

### 파일 및 디렉터리

파일 및 디렉터리에 대한 퍼지 자동 완성은 커서 앞의 단어가 트리거 시퀀스(기본값: `**`)로 끝날 때 트리거될 수 있습니다.

- `COMMAND [DIRECTORY/][FUZZY_PATTERN]**<TAB>`

```sh
# 현재 디렉터리 아래의 파일들
# - TAB 키로 여러 항목을 선택할 수 있습니다.
vim **<TAB>

# 상위 디렉터리 아래의 파일들
vim ../**<TAB>

# 상위 디렉터리 중 `fzf`와 일치하는 파일들
vim ../fzf**<TAB>

# 홈 디렉터리 아래의 파일들
vim ~/**<TAB>

# 현재 디렉터리 아래의 디렉터리들 (단일 선택)
cd **<TAB>

# ~/github 아래 중 `fzf`와 일치하는 디렉터리들
cd ~/github/fzf**<TAB>
```

### 프로세스 ID

kill 명령어를 위해 PID에 대한 퍼지 자동 완성이 제공됩니다.

```sh
# <TAB> 또는 <Shift-TAB> 키로 여러 프로세스를 선택할 수 있습니다.
kill -9 **<TAB>
```

### 호스트 이름

ssh 명령어를 위해 호스트 이름에 대한 퍼지 자동 완성이 제공됩니다. 이름은 /etc/hosts 및 ~/.ssh/config에서 추출됩니다.

```sh
ssh **<TAB>
```

### 환경 변수 / 별칭(Aliases)

```sh
# bash 및 zsh
unset **<TAB>
export **<TAB>
unalias **<TAB>

# fish
set <SHIFT-TAB>
```

### bash 및 zsh용 퍼지 자동 완성 커스텀하기

#### 완성을 위한 fzf 옵션 커스텀하기

```sh
# 기본 ** 대신 ~~를 트리거 시퀀스로 사용
export FZF_COMPLETION_TRIGGER='~~'

# fzf 명령어 옵션
export FZF_COMPLETION_OPTS='--border --info=inline'

# 경로 완성 옵션 (예: vim **<TAB>)
export FZF_COMPLETION_PATH_OPTS='--walker file,dir,follow,hidden'

# 디렉터리 완성 옵션 (예: cd **<TAB>)
export FZF_COMPLETION_DIR_OPTS='--walker dir,follow'

# _fzf_comprun 함수를 통한 fzf 옵션의 고급 커스텀
# - 함수의 첫 번째 인수는 명령어의 이름입니다.
# - 나머지 인수($@)를 fzf에 반드시 전달해야 합니다.
_fzf_comprun() {
  local command=$1
  shift

case "$command" in
    cd)           fzf --preview 'tree -C {} | head -200'   "$@" ;;
    export|unset) fzf --preview "eval 'echo \$'{}"         "$@" ;;
    ssh)          fzf --preview 'dig {}'                   "$@" ;;
    *)            fzf --preview 'bat -n --color=always {}' "$@" ;;
  esac
}
```

#### 경로 및 디렉터리 완성 소스 커스텀하기

```sh
# 경로 후보 목록 표시에 fd(https://github.com/sharkdp/fd) 사용.
# - 함수의 첫 번째 인수($1)는 순회를 시작할 기본 경로입니다.
# - 자세한 내용은 소스 코드(completion.{bash,zsh})를 참조하세요.
_fzf_compgen_path() {
  fd --hidden --follow --exclude ".git" . "$1"
}

# 디렉터리 완성을 위한 목록 생성에 fd 사용
_fzf_compgen_dir() {
  fd --type d --hidden --follow --exclude ".git" . "$1"
}
```

#### 지원되는 명령어 (bash)

bash에서는 미리 정의된 명령어 세트에 대해서만 퍼지 자동 완성이 활성화됩니다(목록을 보려면 `complete | grep _fzf` 실행). 하지만 `_fzf_setup_completion` 헬퍼 함수를 사용하여 다른 명령어에 대해서도 활성화할 수 있습니다.

```sh
# 사용법: _fzf_setup_completion path|dir|var|alias|host COMMANDS...
_fzf_setup_completion path ag git kubectl
_fzf_setup_completion dir tree
```

#### 커스텀 퍼지 자동 완성

_**(커스텀 완성 API는 실험적이며 변경될 수 있습니다)**_

_"COMMAND"_라는 이름의 명령어에 대해 `_fzf_complete` 헬퍼를 사용하여 `_fzf_complete_COMMAND` 함수를 정의하세요.

```sh
# "doge" 명령어를 위한 커스텀 퍼지 자동 완성
#   예: doge **<TAB>
_fzf_complete_doge() {
  _fzf_complete --multi --reverse --prompt="doge> " -- "$@" < <(
    echo very
    echo wow
    echo such
    echo doge
  )
}
```

- `--` 앞의 인수는 fzf 옵션입니다.
- `--` 뒤에는 원래의 완성 인수(`"$@"`)를 그대로 전달합니다.
- 그런 다음 완성 후보를 생성하는 명령어 세트를 작성하고 프로세스 치환(`(< <(...)`)을 사용하여 그 출력을 함수에 전달합니다.

zsh은 명명 규칙에 따라 함수를 자동으로 인식하지만, bash에서는 `complete` 명령어를 사용하여 함수와 명령어를 수동으로 연결해야 합니다.

```sh
[ -n "$BASH" ] && complete -F _fzf_complete_doge -o default -o bashdefault doge
```

fzf의 출력을 후처리해야 하는 경우, 다음과 같이 `_fzf_complete_COMMAND_post`를 정의하세요.

```sh
_fzf_complete_foo() {
  _fzf_complete --multi --reverse --header-lines=3 -- "$@" < <(
    ls -al
  )
}

_fzf_complete_foo_post() {
  awk '{print $NF}'
}

[ -n "$BASH" ] && complete -F _fzf_complete_foo -o default -o bashdefault foo
```

### fish용 퍼지 자동 완성

fish용 퍼지 자동 완성은 다음 점에서 bash 및 zsh와 다릅니다:

- `**` 같은 트리거 시퀀스가 필요 없습니다. 대신 `Shift-TAB`을 누르면 활성화되며(기본 페이저 검색 모드 대체), `TAB`은 fish의 기본 완성 동작을 유지합니다.
- 재귀적 파일 시스템 순회를 수행하는 대신, 후보 목록을 채우기 위해 fish의 기본 완성 시스템을 활용합니다. 재귀 검색을 위해서는 대신 `CTRL-T` 바인딩을 사용하세요.
- 현재 명령줄 토큰이 와일드카드 패턴인 경우, (명령줄의 모든 결과를 삽입하는 기본 동작 대신) 와일드카드 확장 경로 목록에서 검색을 수행합니다. 확장을 위해 셸이 사용되므로 결과 수에 제한이 있습니다.
- 지원되는 설정 변수는 `FZF_COMPLETION_OPTS`와 `FZF_EXPANSION_OPS`뿐입니다.
- 커스텀 완성 함수에서 사용되는 함수의 이름은 `fzf_complete`이며, 이 함수는 fzf 옵션만을 인수로 받습니다. 또한 리다이렉트된 입력 없이 호출하여 기본 완성 결과를 표시하면서 fzf 옵션만 수정할 수도 있습니다. 다른 셸과의 호환성을 위해 명령어 줄에서 fzf 옵션 뒤에 ` -- $argv`를 받을 수 있는 `_fzf_complete` 함수도 제공됩니다.

fish 완성에 포함되지 않은 명령어의 경우, (탭과 시프트 탭 모두에서 작동하는) 일반 fish 완성 함수를 생성하고, 특정 명령어에 대해 fzf 옵션을 수정해야 하거나 `Shift-TAB`에 대해 다른 원할 때만 fzf 완성 함수를 생성하는 것이 좋습니다:

```fish
# git 완성 커스텀
function _fzf_complete_git
  # 모든 git 완성에 대해 활성 브랜치가 포함된 헤더 텍스트 표시
  set -lx -- FZF_COMPLETION_OPTS --header="'"(git branch --show-current 2>/dev/null)"'"

# 인수가 3개 미만이거나 옵션을 완성 중인 경우 다른 변경 없음
  if not set -q argv[3]; or string match -q -- '-*' $argv[-1]
    fzf_complete
    return
  end

# 서브커맨드 확인
  switch $argv[2]
    case checkout diff log show
      # 서브커맨드 checkout, diff, log, show에 대해 미리보기를 설정하고 모든 브랜치와 커밋 표시
      begin
        git branch --all --format='%(refname:short)'
        git log --all --oneline --color=always
      end | fzf_complete --no-multi --ansi --accept-nth=1 --query=$argv[-1] --preview='git show --color=always {1}'

case add rm mv
      # 서브커맨드 add, rm, mv에 대해서만 미리보기 설정
      # fish 완성 목록의 특수 문자는 이스케이프되므로 r 플래그를 사용해야 합니다.
      fzf_complete --preview="git diff --color=always {r1}"

case '*'
      # 다른 서브커맨드는 변경 없음
      fzf_complete
  end
end
```

bash 및 zsh와 유사하게, `_fzf_complete_COMMAND_post` 또는 `_fzf_post_complete_COMMAND`라는 이름의 함수를 정의하여 fzf 출력을 명령줄에 삽입하기 전에 처리할 수 있습니다:

```fish
function _fzf_complete_foo
  ls -sh --zero --color=always | fzf_complete --read0 --print0 --ansi --no-multi-line --header-lines=1
end

function _fzf_post_complete_foo
  while read -lz result
    string escape -n -- $result | string trim -l -c '\ ' | string split -m 1 -f 2 ' '
  end
end
```

### Nushell용 퍼지 자동 완성

Nushell의 퍼지 자동 완성은 [external completer](https://www.nushell.sh/cookbook/external_completers.html) 메커니즘을 통해 작동합니다. bash 및 zsh와 비교하여 몇 가지 차이점이 있습니다:

- Nushell >= 0.103.0부터는 내장 명령어(예: `cd`, `ls`)에 대해 external completer가 더 이상 호출되지 않습니다. `**<TAB>`을 이용한 퍼지 자동 완성은 외부 명령어에서만 작동합니다.
- 커스텀 completer는 `config.nu`의 `$env.FZF_COMPLETERS` 레코드를 통해 정의할 수 있습니다. 각 항목은 접두사와 명령어 범위를 받아 후보 문자열 목록이나 커스텀 fzf 옵션을 위한 레코드 `{ candidates: [...], opts: [...] }`를 반환하는 클로저입니다:
  ```nu
  $env.FZF_COMPLETERS = {
      pacman: {|prefix, spans|
          let sub = $spans | skip 1 | first
          let candidates = (if ($sub =~ "-[SF]") { ^pacman -Slq | lines
          } else if ($sub =~ "-[QR]") { ^pacman -Qq | lines
          } else { [] })
          { candidates: $candidates, opts: ["--preview", "pacman -Si {}"] }
      }
  }
  ```
  더 많은 예제는 [shell/completion-examples.nu](shell/completion-examples.nu)를 참고하세요.
- 다음 환경 변수들이 지원됩니다:
  `FZF_COMPLETION_TRIGGER`, `FZF_COMPLETION_OPTS`,
  `FZF_COMPLETION_PATH_OPTS`, `FZF_COMPLETION_DIR_OPTS`,
  `FZF_COMPLETION_DIR_COMMANDS`.

Vim 플러그인
----------

[README-VIM.md](README-VIM.md)를 참고하세요.

고급 주제
---------------

### 다양한 유형의 입력에 맞게 커스텀하기

fzf는 범용 텍스트 필터이므로, 그 알고리즘은 모든 종류의 입력에서 "일반적으로" 잘 작동하도록 설계되었습니다. 하지만 진정으로 모든 용도에 맞는 단 하나의 솔루션이란 존재하지 않으며, 입력 유형에 따라 알고리즘과 일부 설정을 조정하고 싶을 수 있습니다. 이 과정을 쉽게 만들기 위해, fzf는 몇 가지 일반적인 입력 유형에 대한 "scheme" 세트를 제공합니다.

(자세한 내용은 `fzf --man` 참조)

### 성능

fzf는 빠릅니다. 대부분의 사용 사례에서 성능은 문제가 되지 않습니다. 하지만 성능에 영향을 줄 수 있는 옵션들을 알아두는 것이 좋습니다.

- `--ansi`는 fzf에게 입력에서 ANSI 색상 코드를 추출하고 파싱하도록 지시하므로 초기 스캔이 느려집니다. 따라서 `$FZF_DEFAULT_OPTS`에 추가하는 것은 권장되지 않습니다.
- `--nth`는 각 라인을 토큰화해야 하므로 fzf를 느리게 만듭니다.
- 정규 표현식 구분 문자보다는 일반 문자열 구분 문자(`--delimiter`)를 사용하는 것이 좋습니다.
- `--with-nth`는 fzf가 각 라인을 토큰화하고 재조합해야 하므로 fzf를 느리게 만듭니다.

### 외부 프로그램 실행

fzf를 벗어나지 않고 외부 프로세스를 시작하기 위한 키 바인딩을 설정할 수 있습니다(`execute`, `execute-silent`).

```bash
# fzf를 종료하지 않고 F1을 눌러 less로 파일 열기
# CTRL-Y를 눌러 라인을 클립보드에 복사하고 fzf 중단 (pbcopy 필요)
fzf --bind 'f1:execute(less -f {}),ctrl-y:execute-silent(echo {} | pbcopy)+abort'
```

자세한 내용은 맨 페이지의 *KEY/EVENT BINDINGS* 섹션을 참고하세요.

### 다른 프로세스로 전환하기

`become(...)`은 위에서 설명한 `execute(...)`/`execute-silent(...)`와 유사하지만, 명령어를 실행하고 완료되면 fzf로 돌아오는 대신, fzf 자체를 해당 명령어의 새로운 프로세스로 전환합니다.

```sh
fzf --bind 'enter:become(vim {})'
```

얼핏 보기에 동일해 보이는 명령어 substitution `vim "$(fzf)"`와 비교했을 때, 이 접근 방식은 몇 가지 장점이 있습니다.

* <kbd>CTRL-C</kbd>로 fzf를 종료할 때 Vim이 빈 파일을 열지 않습니다.
* 빈 결과에서 <kbd>ENTER</kbd>를 누를 때 Vim이 빈 파일을 열지 않습니다.
* 공백이 포함된 경우에도 다중 선택을 처리할 수 있습니다.
  ```sh
  fzf --multi --bind 'enter:become(vim {+})'
  ```

공정하게 말하자면, `vim "$(fzf)"` 대신 `fzf --print0 | xargs -0 -o vim`을 실행하는 것도 언급된 문제들을 해결해 줍니다. 그럼에도 불구하고 `become(...)`은 다양한 시나리오에서 추가적인 이점을 제공합니다.

* 별도의 래퍼 스크립트 없이 여러 바인딩을 설정하여 결과를 다양한 방식으로 처리할 수 있습니다.
  ```sh
  fzf --bind 'enter:become(vim {}),ctrl-e:become(emacs {})'
  ```
  * 이전에 방식에서는 `--expect=ctrl-e`를 사용하고 fzf 출력의 첫 번째 줄을 확인해야 했습니다.
* fzf의 필드 인덱스 표현식을 사용하여 후속 명령어를 쉽게 빌드할 수 있습니다.
  ```sh
  # Vim에서 파일을 열고 해당 라인으로 이동
  git grep --line-number . |
      fzf --delimiter : --nth 3.. --bind 'enter:become(vim {1} +{2})'
  ```

### 후보 목록 새로고침

키나 이벤트에 `reload` 액션을 바인딩하여 fzf가 동적으로 후보 목록을 새로고침하도록 만들 수 있습니다. 자세한 내용은 https://github.com/junegunn/fzf/issues/1750을 참고하세요.

#### 1. CTRL-R을 눌러 프로세스 목록 업데이트하기

```sh
ps -ef |
  fzf --bind 'ctrl-r:reload(ps -ef)' \
      --header 'Press CTRL-R to reload' --header-lines=1 \
      --height=50% --layout=reverse
```

#### 2. CTRL-D 또는 CTRL-F를 눌러 소스 전환하기

```sh
FZF_DEFAULT_COMMAND='find . -type f' \
  fzf --bind 'ctrl-d:reload(find . -type d),ctrl-f:reload(eval "$FZF_DEFAULT_COMMAND")' \
      --height=50% --layout=reverse
```

#### 3. 대화형 ripgrep 통합

다음 예제는 ripgrep의 셀렉터 인터페이스로 fzf를 사용합니다. `change` 이벤트에 `reload` 액션을 바인딩했으므로, fzf에 타이핑할 때마다 placeholder 표현식 `{q}`로 표시된 업데이트된 쿼리 문자열과 함께 ripgrep 프로세스가 다시 시작됩니다. 또한, fzf가 보조 필터링을 수행하지 않도록 `--disabled` 옵션을 사용했습니다.

```sh
: | rg_prefix='rg --column --line-number --no-heading --color=always --smart-case' \
    fzf --bind 'start:reload:$rg_prefix ""' \
        --bind 'change:reload:$rg_prefix {q} || true' \
        --bind 'enter:become(vim {1} +{2})' \
        --ansi --disabled \
        --height=50% --layout=reverse
```

ripgrep이 일치하는 항목을 찾지 못하면 0이 아닌 종료 상태로 종료되고, fzf가 이에 대해 경고합니다. 경고 메시지를 숨기기 위해 명령어에 `|| true`를 추가하여 항상 0으로 종료되도록 했습니다.

더 정교한 예제는 ["Using fzf as interactive Ripgrep launcher"](https://github.com/junegunn/fzf/blob/master/ADVANCED.md#using-fzf-as-interactive-ripgrep-launcher)를 참고하세요.

### 미리보기 창

`--preview` 옵션이 설정되면, fzf는 현재 라인을 인수로 하여 외부 프로세스를 자동으로 시작하고 그 결과를 분할 창에 표시합니다. `$SHELL -c COMMAND`를 사용하여 명령어를 실행할 때 사용자의 `$SHELL`이 사용됩니다.
창은 마우스나 커스텀 키 바인딩을 사용하여 스크롤할 수 있습니다.

```bash
# {}는 포커스된 라인의 싱글 쿼트 문자열로 대체됩니다.
fzf --preview 'cat {}'
```

미리보기 창은 ANSI 색상을 지원하므로, [Bat](https://github.com/sharkdp/bat)이나 [Highlight](https://gitlab.com/saalen/highlight)와 같이 파일 내용을 구문 강조(syntax-highlight)하는 모든 프로그램을 사용할 수 있습니다.

```bash
fzf --preview 'bat --color=always {}' --preview-window '~3'
```

`--preview-window` 옵션을 사용하여 미리보기 창의 크기, 위치, 테두리를 커스텀할 수 있으며, `--color` 옵션으로 전경색과 배경색을 커스텀할 수 있습니다. 예를 들어:

```bash
fzf --height 40% --layout reverse --info inline --border \
    --preview 'file {}' --preview-window up,1,border-horizontal \
    --bind 'ctrl-/:change-preview-window(50%|hidden|)' \
    --color 'fg:#bbccdd,fg+:#ddeeff,bg:#334455,preview-bg:#223344,border:#778899'
```

전체 옵션 목록은 맨 페이지(`man fzf`)를 참조하세요.

더 고급 예제는 [여기](https://github.com/junegunn/fzf/blob/master/ADVANCED.md)에서 찾을 수 있습니다.

> [!WARNING]
> fzf는 파일 파인더가 아니라 범용 텍스트 필터이므로, **`$FZF_DEFAULT_OPTS`에 `--preview` 옵션을 추가하는 것은 좋은 생각이 아닙니다**.
>
> ```sh
> # *********************
> # ** 이렇게 하지 마세요! **
> # *********************
> export FZF_DEFAULT_OPTS='--preview "bat --style=numbers --color=always --line-range :500 {}"'
>
> # bat은 파일 목록 외의 입력에서는 작동하지 않습니다.
> ps -ef | fzf
> seq 100 | fzf
> history | fzf
> ```

### 이미지 미리보기

fzf는 다음 프로토콜 중 하나를 사용하여 미리보기 창에 이미지를 표시할 수 있습니다:

* [Kitty graphics protocol](https://sw.kovidgoyal.net/kitty/graphics-protocol/)
* [iTerm2 inline images protocol](https://iterm2.com/documentation-images.html)
* [Sixel](https://en.wikipedia.org/wiki/Sixel)

자세한 내용은 [bin/fzf-preview.sh](bin/fzf-preview.sh) 스크립트를 참고하세요.

```sh
fzf --preview 'fzf-preview.sh {}'
```

팁
----

### `.gitignore` 준수하기

`.gitignore`를 준수하면서 파일 시스템을 순회하기 위해 [fd](https://github.com/sharkdp/fd), [ripgrep](https://github.com/BurntSushi/ripgrep), 또는 [the silver searcher](https://github.com/ggreer/the_silver_searcher)를 사용할 수 있습니다.

```sh
# fd의 출력을 fzf에 공급
fd --type f --strip-cwd-prefix | fzf

# fzf의 기본 소스로 fd 설정
export FZF_DEFAULT_COMMAND='fd --type f --strip-cwd-prefix'

# 이제 fzf(파이프 없이)는 목록 생성에 fd 명령어를 사용합니다.
fzf

# 이 명령어를 CTRL-T에도 적용하려면
export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"
```

명령어가 심볼릭 링크를 따르도록 하고 숨김 파일은 제외하지 않으려면 다음 명령어를 사용하세요:

```sh
export FZF_DEFAULT_COMMAND='fd --type f --strip-cwd-prefix --hidden --follow --exclude .git'
```

### Fish 셸

fish의 `CTRL-T` 키 바인딩은 bash 및 zsh와 달리 재귀 검색의 루트 디렉터리로 명령줄의 마지막 토큰을 사용합니다. 예를 들어, 다음 명령줄의 끝에서 `CTRL-T`를 누르면:

```sh
ls /var/
```

`/var/` 아래의 모든 파일과 디렉터리가 나열됩니다.

커스텀 `FZF_CTRL_T_COMMAND`를 사용할 때는 이 기능을 활용하기 위해 확장되지 않은 `$dir` 변수를 사용하세요. 마지막 토큰이 유효한 디렉터리가 아닐 경우 `$dir`은 기본적으로 `.`이 됩니다. 예제:

```sh
set -g FZF_CTRL_T_COMMAND "command find -L \$dir -type f 2> /dev/null | sed '1d; s#^\./##'"
```

### fzf 테마 플레이그라운드

[Vitor Mello](https://github.com/vitormv)가 만든 [fzf Theme Playground](https://vitormv.github.io/fzf-themes/)는 fzf 테마를 대화형으로 생성할 수 있는 웹페이지입니다.

fzf

fzf 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

fzf

fzf 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README