대상 사용자: 프로그래머. fd는 프로젝트 폴더에서 파일 이름·확장자·경로를 찾는 명령줄 유틸리티입니다. 생성된 빌드 파일을 제외하고 소스 파일을 찾거나, 문서 경로를 좁혀 확인할 때 유용합니다. 파일 본문의 문자열을 찾으려면 ripgrep 사용 가이드를 참고하세요.
이 자료는 fd 10.5.0 / Windows x64 / PowerShell을 기준으로 작성했습니다. 2026년 9월 22일 확인한 공식 릴리스의 원본 ZIP과 한국어 설명서·실습 ZIP을 첨부합니다. Linux·macOS·Windows ARM64는 공식 프로젝트에서 해당 환경에 맞는 배포물을 선택하세요.
게시글 아래 첨부파일 영역에서 다음 두 ZIP을 받을 수 있습니다.
| 첨부파일 | 포함 내용 |
|---|---|
| fd-v10.5.0-x86_64-pc-windows-msvc.zip | 제작자의 수정하지 않은 공식 ZIP. fd.exe, README, 변경 이력, 매뉴얼, 자동완성 및 원문 라이선스 |
| fd-10.5.0-korean-guide-practice.zip | 한국어 HTML·Markdown 설명서, 합성 샘플, 검증 스크립트와 기대 결과. fd 실행파일은 이 설명서 ZIP에 중복 포함하지 않음 |
fd는 MIT 또는 Apache-2.0 조건으로 제공됩니다. 공식 ZIP에 들어 있는 LICENSE-MIT, LICENSE-APACHE와 기존 고지문을 그대로 보존했습니다. 두 ZIP의 SHA-256은 글 끝에서 확인할 수 있습니다. 자체 작성한 설명서·샘플은 함께 제공한 LICENSE-GUIDE.txt를 따르며, fd와 구성요소의 원래 라이선스는 바뀌지 않습니다.
제작자의 Windows x64 ZIP 직접 다운로드도 사용할 수 있습니다. 이 자료의 공식 ZIP에는 실행파일이 실제 포함되어 있으며, 별도의 설치 마법사 없이 압축을 풀어 실행하는 방식입니다.
fd.exe와 문서·라이선스 파일을 함께 보관합니다.README-KO.html은 브라우저로 오프라인 열람할 수 있습니다.&로 실행할 수 있습니다.버전 출력은 fd 10.5.0입니다. PATH를 영구 변경할 필요는 없습니다. 현재 폴더에 실행파일이 있다면 ./fd.exe --version처럼 경로를 명시해도 됩니다.
설명서 ZIP의 최상위 폴더, 즉 sample 폴더가 보이는 위치에서 실행합니다.
첫 명령은 main.c, sensor.c, sensor_test.c 세 파일을 찾습니다. -t f는 일반 파일로 제한하고, -e c는 확장자를 고릅니다. 두 번째는 sensor.c, sensor_test.c, sensor.h 세 파일을, 세 번째는 release notes.md 한 파일을 찾습니다. 결과에는 폴더 경로가 붙으며 병렬 검색 때문에 표시 순서는 달라질 수 있습니다.
기본 검색 패턴은 정규식입니다. -g는 glob 패턴, -F는 문자열 그대로의 부분 일치를 사용합니다. .을 파일명에서 문자 그대로 찾으려는 경우 정규식의 의미와 혼동하지 않도록 -F를 선택할 수 있습니다. 기본 검색 대상은 파일 이름이며 본문 내용은 읽지 않습니다. 이러한 옵션의 정의는 10.5.0 공식 매뉴얼을 기준으로 합니다.
실습의 sample/.fdignore에는 build/가 들어 있습니다. 따라서 앞의 기본 검색에서는 build/generated.c가 제외됩니다.
-I를 넣은 첫 검색은 생성 파일까지 포함해 C 파일 네 개를 반환합니다. 두 번째는 경로에 docs가 포함된 Markdown 파일을 찾습니다. 이 실습에서는 docs 아래의 README.md, release notes.md 두 문서가 나옵니다. docs는 경로의 일부를 찾는 패턴이므로 정확한 폴더 일치가 필요하면 경로 구분자까지 고려해 패턴을 작성합니다.
프로젝트의 .gitignore는 Git 저장소 인식 여부에 영향을 받습니다. .fdignore는 fd 전용 제외 규칙으로 사용할 수 있습니다. 기본 결과에서 빠진 항목이 있을 때는 규칙 파일과 검색 시작 폴더를 먼저 확인하세요. 숨김 포함은 -H, 제외 규칙 무시는 -I로 구분됩니다. 두 옵션을 함께 사용하면 검색 범위가 넓어집니다. Windows에서는 파일의 숨김 속성도 확인해야 합니다. 공식 사용법과 문제 해결을 함께 참고하세요.
-q는 결과 목록 대신 종료 코드로 존재 여부를 알려줍니다. 이 실습에서는 첫 검색이 0, 두 번째가 1입니다. 오류가 없는 일반 목록 검색은 결과가 비어 있어도 같은 의미로 판단하면 안 됩니다. 존재 확인을 자동화할 때는 -q를 명시하고 호출 직후 종료 코드를 확인합니다.
스크립트는 압축 해제한 sample 안의 합성 파일만 검색합니다. 숨김 테스트를 재현하기 위해 sample/.hidden.txt에 Windows 숨김 속성을 설정하고, 작업이 끝나면 원래 속성으로 복구합니다. 기본 C 검색, 제외 규칙 해제, glob, 공백 이름, 전체 경로, 두 가지 존재 확인, 숨김 제외·포함 등 9개 검사를 수행합니다. 모두 통과하면 PASS: 9 fd practice checks가 표시됩니다.
조직의 정책 때문에 스크립트 실행이 차단되면 정책을 무작정 변경하지 말고 설명서의 개별 명령을 실행해 expected-results.json과 비교합니다. 검증 스크립트는 결과 순서가 아니라 경로 집합을 비교하므로 출력 순서가 바뀌어도 정상으로 판정합니다.
| 증상 | 확인·해결 방법 |
|---|---|
| fd를 명령으로 찾지 못함 | $fdPath가 fd.exe의 실제 경로인지 확인하고 & $fdPath --version 실행 |
| 소스 파일이 일부 빠짐 | 검색 시작 폴더, .gitignore·.ignore·.fdignore, 숨김 속성을 확인. 필요한 범위에서 -H 또는 -I 적용 |
| 같은 단어인데 대소문자 결과가 다름 | 기본 smart-case 동작 확인. 대소문자 무시를 고정하려면 -i, 구분하려면 -s 사용 |
| 경로 일부를 넣었는데 찾지 못함 | 기본은 이름 비교이므로 전체 경로가 필요하면 -p 사용 |
| 공백이나 별표가 있는 패턴이 의도와 다름 | PowerShell에서 패턴을 따옴표로 묶고 정규식·glob·문자열 모드를 구분 |
| 실습 결과가 기대값과 다름 | ZIP을 새 폴더에 풀고 정확한 10.5.0 버전인지 확인. 외부 상위 폴더·전역 제외 규칙 영향도 점검 |
이 가이드는 검색과 결과 확인까지만 다룹니다. 파일을 바꾸는 외부 명령과 결합할 때는 검색 대상을 먼저 검토해야 합니다. fd의 -x 실행 기능은 병렬로 동작할 수 있으므로 파일 변경 작업을 무심코 연결하지 마세요.
2026년 9월 22일 Windows x64에서 공식 실행파일로 9개 실습을 확인했습니다. 공식 원본 ZIP의 SHA-256은 제작자의 릴리스 API digest와 대조했습니다. 다른 운영체제·CPU 조합과 GUI 설치 과정은 시험하지 않았습니다.