ripgrep 15.2.0 Windows x64 다운로드·사용법 (프로그래머용 소스·로그 검색)

대상 사용자: 프로그래머. ripgrep(rg)은 소스와 텍스트 로그에서 문자열을 찾는 명령행 도구입니다. 이 자료는 Windows x64에서 15.2.0 공식 ZIP을 풀어 사용하고, 작은 가상 프로젝트로 검색 결과를 확인하는 한국어 안내입니다. 확인일은 2026-09-20입니다.

첨부 파일과 공식 출처

ripgrep-15.2.0-x86_64-pc-windows-msvc.zip: 공식 Windows x64 포터블 원본입니다. rg.exe, 공식 문서, COPYING, LICENSE-MIT, UNLICENSE를 포함하며 파일을 수정하거나 재포장하지 않았습니다. 별도 설치 마법사는 없습니다.
ripgrep-15.2.0-korean-guide-practice.zip: 한국어 설명서 MD·HTML, 가상 소스·로그, 예상 결과, 검증 스크립트입니다. 이 실습 ZIP에는 실행 파일이 들어 있지 않으므로 위 공식 ZIP도 함께 받으세요.

원본은 공식 15.2.0 릴리스의 Windows x64 ZIP입니다. 다른 OS·CPU는 릴리스 목록에서 해당 빌드를 선택하세요. 본문 명령은 Windows PowerShell 기준입니다.

공식 원본 ZIP의 SHA-256은 아래와 같습니다. GitHub 릴리스 API가 제공한 해당 자산의 digest와 다운로드 바이트가 일치하는지 확인했습니다.

71b2fef860abe467217a538ff31de02f5258807c0129f771846f87bd029aafc5

1. 압축을 풀고 실행 확인하기

두 ZIP을 각각 압축 해제합니다. 공식 폴더 안에 rg.exe가 있는지 확인합니다.
실습 폴더에는 README-KO.html, sample, verify-practice.ps1이 있어야 합니다. HTML 설명서는 브라우저에서 오프라인으로 열 수 있습니다.
PowerShell을 열고 아래 $rg 값만 실제 실행 파일 경로로 바꿉니다. 사용자 PATH를 변경할 필요는 없습니다.

$rg = 'C:\Tools\ripgrep-15.2.0-x86_64-pc-windows-msvc\rg.exe'

& $rg --version

첫 줄에 ripgrep 15.2.0이 표시되어야 합니다. 이후 명령은 실습 ZIP을 푼 폴더를 현재 위치로 하여 실행합니다. 탐색기에서 해당 폴더를 연 뒤 터미널을 열거나 Set-Location '실습 폴더의 실제 경로'를 사용하세요.

2. 함수 이름을 그대로 찾기

아래 코드는 C 파일에서 sensor_read( 문자열을 찾습니다. 괄호를 정규식으로 해석하지 않도록 -F를 사용합니다. 결과를 반복 확인하기 쉽도록 정렬·색상·파일명 표시도 고정했습니다.

& $rg --no-config --sort path --color never --no-heading -n -H -F 'sensor_read(' -g '*.c' sample

이 실습에서는 sample\src\main.c의 2번 줄과 sample\src\sensor.c의 1번 줄, 총 두 줄이 나옵니다. build는 실습용 .ignore에서 제외했고 notes.txt는 C 파일이 아니므로 나오지 않습니다. 파일을 편집하는 명령이 아니며 검색 결과만 출력합니다.

3. 오류 로그와 파일 목록 확인하기

& $rg --no-config --color never -n '^ERROR\b' sample/logs/device.log

& $rg --no-config --sort path --files -g '*.c' sample

첫 명령은 2번 줄 ERROR timeout bus=1과 4번 줄 ERROR crc seq=8을 찾습니다. 두 번째는 문자열 검색이 아니라 검색 대상 C 파일의 경로 두 개를 나열합니다. 대소문자를 무시하려면 -i를 추가하고, 문자 자체를 찾을 때는 -F를 우선 사용하세요.

4. 검색에서 빠진 파일의 이유 확인하기

& $rg --no-config --no-ignore --sort path --color never --no-heading -n -H -F 'sensor_read(' -g '*.c' sample

& $rg --no-config --hidden --color never -n -H -F 'HIDDEN_MARKER' sample

첫 명령은 ignore 규칙을 해제해 sample\build\generated.c의 1번 줄도 포함하므로 세 줄이 나옵니다. 두 번째는 점으로 시작하는 sample\.hidden-note.txt의 1번 줄을 찾습니다. --hidden은 숨김 경로 포함 옵션이고 --no-ignore는 ignore 규칙 해제 옵션이므로 역할이 다릅니다. 실습은 Git 저장소가 없어도 작동하는 .ignore를 사용합니다. 실제 저장소의 .gitignore 적용은 Git 저장소 인식 여부도 확인하세요. 자세한 규칙은 공식 GUIDE에 있습니다.

5. 자동 검사와 종료 코드

설정한 $rg를 사용해 같은 PowerShell 창에서 아래 명령을 실행할 수 있습니다. 스크립트 내용을 먼저 열어 확인할 수 있으며, 샘플 검색과 결과 비교만 수행합니다.

.\verify-practice.ps1 -RgPath $rg

정상 결과는 PASS: 7 ripgrep practice checks입니다. 스크립트 실행이 조직 정책으로 차단되면 정책을 변경하지 말고 위 개별 검색 명령과 expected-results.txt를 비교하세요.

일반 검색에서 종료 코드 0은 일치 발견, 1은 일치 없음, 2는 오류입니다. 검색 직후 $LASTEXITCODE로 확인합니다. 이 안내의 검증 스크립트는 일치 없음과 잘못된 정규식도 시험합니다. 15.2.0 공식 옵션·종료 코드 구현은 배포 ZIP의 doc/rg.1과 함께 참고할 수 있습니다.

6. 문제 해결

rg가 명령으로 인식되지 않음: 위처럼 $rg에 전체 경로를 지정하고 호출 연산자 &를 붙입니다. 경로에 공백이 있어도 작은따옴표 안에 넣으면 됩니다.
검색 결과가 비어 있음: 현재 폴더, 대상 경로, -g 패턴, 대소문자, .ignore 규칙을 확인합니다. 실습 파일이 빠지지 않았는지 --files로 먼저 확인하세요.
괄호·대괄호 때문에 정규식 오류 발생: 문자 그대로 찾으려는 검색이면 -F를 사용합니다. 정규식을 의도했다면 닫는 괄호와 이스케이프를 확인합니다.
다른 PC에서 결과가 다름: --no-config는 ripgrep 설정 파일 영향을 줄이지만 ignore 파일까지 없애지는 않습니다. 이 실습의 폴더 구조와 옵션을 그대로 비교하세요.
한글 로그가 깨짐: 파일 인코딩을 확인합니다. UTF-8 실습 파일은 기본 검색이 가능하며, 다른 인코딩은 공식 도움말의 --encoding 옵션과 실제 파일 인코딩을 맞춰야 합니다.
Windows가 실행을 차단함: 받은 경로가 공식 릴리스와 일치하는지 확인하고 조직 정책을 따릅니다. 보안 기능을 끄는 방법은 설치 절차에 포함하지 않습니다.

라이선스와 검증 범위

ripgrep은 COPYING에 따라 MIT 또는 Unlicense 중 하나를 선택할 수 있습니다. 이 자료는 MIT 고지를 보존하여 공식 원본을 재배포하며, 원본에 포함된 나머지 고지와 문서도 그대로 유지했습니다. 한국어 설명서와 가상 실습 파일은 JDevCompany 작성물로 CC0-1.0을 적용합니다. ripgrep 자체의 라이선스와 구분됩니다.

Windows에서 첨부할 공식 실행 파일의 버전을 확인하고 7개 검색·종료 코드 검사를 실행했습니다. ZIP CRC와 원본 해시도 확인했습니다. 설치 마법사, PATH 변경, Linux·macOS·ARM 빌드는 이번 실습에서 시험하지 않았습니다.