대상 사용자: 프로그래머. 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에는 실행파일이 실제 포함되어 있으며, 별도의 설치 마법사 없이 압축을 풀어 실행하는 방식입니다.
Windows에서 준비하기
- Windows 설정의 시스템 정보에서 x64 기반 PC인지 확인합니다. ARM64 PC라면 이 첨부 대신 공식 ARM64 배포물을 선택합니다.
- 공식 ZIP을 압축 해제합니다. 안쪽 폴더의
fd.exe와 문서·라이선스 파일을 함께 보관합니다. - 설명서·실습 ZIP은 별도 폴더에 압축 해제합니다.
README-KO.html은 브라우저로 오프라인 열람할 수 있습니다. - 실습 폴더에서 PowerShell을 열고 실제 경로에 맞춰 다음 변수를 설정합니다. 경로에 공백이 있어도 따옴표와 호출 연산자
&로 실행할 수 있습니다.
버전 출력은 fd 10.5.0입니다. PATH를 영구 변경할 필요는 없습니다. 현재 폴더에 실행파일이 있다면 ./fd.exe --version처럼 경로를 명시해도 됩니다.
실습 1: 소스 확장자와 파일 이름 검색
설명서 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 공식 매뉴얼을 기준으로 합니다.
실습 2: 제외 규칙과 경로 검색
실습의 sample/.fdignore에는 build/가 들어 있습니다. 따라서 앞의 기본 검색에서는 build/generated.c가 제외됩니다.
-I를 넣은 첫 검색은 생성 파일까지 포함해 C 파일 네 개를 반환합니다. 두 번째는 경로에 docs가 포함된 Markdown 파일을 찾습니다. 이 실습에서는 docs 아래의 README.md, release notes.md 두 문서가 나옵니다. docs는 경로의 일부를 찾는 패턴이므로 정확한 폴더 일치가 필요하면 경로 구분자까지 고려해 패턴을 작성합니다.
프로젝트의 .gitignore는 Git 저장소 인식 여부에 영향을 받습니다. .fdignore는 fd 전용 제외 규칙으로 사용할 수 있습니다. 기본 결과에서 빠진 항목이 있을 때는 규칙 파일과 검색 시작 폴더를 먼저 확인하세요. 숨김 포함은 -H, 제외 규칙 무시는 -I로 구분됩니다. 두 옵션을 함께 사용하면 검색 범위가 넓어집니다. Windows에서는 파일의 숨김 속성도 확인해야 합니다. 공식 사용법과 문제 해결을 함께 참고하세요.
실습 3: 검색 성공 여부를 스크립트에서 확인
-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 설치 과정은 시험하지 않았습니다.
첨부파일 SHA-256
공식 원본과 설명서 ZIP을 구분해 비교하세요.
fd-v10.5.0-x86_64-pc-windows-msvc.zip
fd-10.5.0-korean-guide-practice.zip