대상 사용자: 프로그래머(Windows 10/11 64비트에서 CLI 명령·빌드 도구의 실행 시간을 비교하려는 분). hyperfine은 동일 명령을 여러 번 실행해 평균과 변동을 보여 주는 명령줄 벤치마크 도구입니다. 이 글은 공식 v1.20.0 Windows x64 배포 ZIP과 한국어 설명서·실습 ZIP을 제공합니다. 측정값은 컴퓨터와 부하에 따라 달라지므로 예제의 목적은 측정 절차 확인입니다.
1. 다운로드와 라이선스
이 글의 첨부 hyperfine-v1.20.0-x86_64-pc-windows-msvc.zip은 개발자의 공식 v1.20.0 릴리스에 있는 원본 ZIP 그대로입니다. SHA-256은 아래에 적었으며 ZIP 내부의 LICENSE-MIT, LICENSE-APACHE, README.md를 보존했습니다. hyperfine은 MIT 또는 Apache-2.0으로 배포됩니다. 원본 ZIP을 받기보다 최신 버전을 고르려면 공식 릴리스 목록을 이용하세요. 이 게시물의 설명서와 실습 파일은 자체 제작 자료로 CC0-1.0입니다.
첨부 hyperfine-korean-guide-practice.zip에는 README-KO.md, 브라우저로 열 수 있는 README-KO.html, demo-fast.cmd, demo-slow.cmd, expected-results.txt, LICENSE-GUIDE.txt가 있습니다. ZIP 두 개를 같은 작업 폴더 아래에 각각 압축 해제하세요. 회사 코드나 개인정보는 실습에 넣지 않았습니다.
2. 설치 없이 실행
- 원본 ZIP을 모두 풀고 그 안의
hyperfine.exe를 찾습니다.LICENSE-MIT와LICENSE-APACHE도 같은 폴더에 남겨 둡니다. 공식 ZIP은 Windows 64비트용입니다. ARM64·32비트 또는 다른 운영체제에서는 공식 릴리스에서 맞는 패키지를 선택하세요. - Windows PowerShell에서 압축 해제 폴더로 이동한 뒤
.\hyperfine.exe --version을 실행합니다. 정상이라면hyperfine 1.20.0이 출력됩니다. PATH 변경이나 관리자 권한은 이 실습에 필요하지 않습니다. - 한국어 실습 ZIP을 푼 폴더에서 아래 명령을 실행합니다. PowerShell에서
--뒤의 따옴표는 두 벤치마크 명령을 각각 하나의 인수로 전달합니다.hyperfine.exe의 실제 위치에 맞춰 경로를 바꾸세요.
--warmup 1은 각 명령을 사전 실행하고, --runs 5는 측정 반복 수입니다. demo-fast.cmd는 간단한 출력만 수행하고 demo-slow.cmd는 짧게 대기합니다. 서로 다른 프로그램의 실제 성능 순위를 증명하는 예제가 아닙니다. Windows 프로세스 시작 비용과 시스템 부하가 포함됩니다. 공식 사용법
3. 자신의 작업에 적용
빌드 도구를 비교할 때는 동일 입력, 동일 작업 폴더, 동일 출력 상태에서 실행하세요. 파일 캐시나 증분 빌드 때문에 첫 실행과 이후 실행이 달라질 수 있습니다. 비교하려는 조건을 먼저 정하고 --warmup과 --prepare를 사용합니다. --prepare 명령은 매 측정 전에 실행되므로 삭제·정리 명령을 넣을 때 경로를 확인하세요. 측정 결과를 나중에 분석하려면 --export-json results.json을 추가합니다. 출력 파일에는 실행 명령 문자열이 들어갈 수 있으니 공유 전에 내부 경로를 확인하세요. 공식 기능·JSON 출력 안내
4. 문제 해결
hyperfine을 찾을 수 없음: PowerShell에서hyperfine.exe가 있는 폴더로 이동하여.\hyperfine.exe --version을 실행합니다. 명령을 PATH에 넣지 않았다면 이름만 쓰지 않습니다.- 실습 명령이 실행되지 않음: 두 ZIP을 푼 위치와
demo-fast.cmd·demo-slow.cmd의 상대 경로를 확인합니다. 먼저cmd /c .\demo-fast.cmd로 스크립트만 실행해 보세요. 원본 ZIP 내부의 한 단계 폴더를 누락하면 예시 경로와 달라집니다. - 측정 결과가 들쭉날쭉함: 백그라운드 빌드·업데이트를 멈추고 같은 입력으로 다시 측정합니다. 짧은 명령은 프로세스 시작 비용의 비중이 큽니다. 평균만 보지 말고 표준편차도 함께 보세요.
- 대상 명령이 오류 종료: 먼저 해당 명령을 단독 실행해 종료 코드와 입력 파일을 확인합니다. 실패를 무시한 시간은 성공한 작업의 성능 비교가 아닙니다.
원본 및 이용 조건: hyperfine 저장소, MIT 고지문, Apache-2.0 고지문.
첨부 SHA-256
hyperfine-v1.20.0-x86_64-pc-windows-msvc.zip
hyperfine-korean-guide-practice.zip