hyperfine 한국어 설명서

대상 사용자: 프로그래머(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. 설치 없이 실행

  1. 원본 ZIP을 모두 풀고 그 안의 hyperfine.exe를 찾습니다. LICENSE-MIT와 LICENSE-APACHE도 같은 폴더에 남겨 둡니다. 공식 ZIP은 Windows 64비트용입니다. ARM64·32비트 또는 다른 운영체제에서는 공식 릴리스에서 맞는 패키지를 선택하세요.
  2. Windows PowerShell에서 압축 해제 폴더로 이동한 뒤 .\hyperfine.exe --version을 실행합니다. 정상이라면 hyperfine 1.20.0이 출력됩니다. PATH 변경이나 관리자 권한은 이 실습에 필요하지 않습니다.
  3. 한국어 실습 ZIP을 푼 폴더에서 아래 명령을 실행합니다. PowerShell에서 -- 뒤의 따옴표는 두 벤치마크 명령을 각각 하나의 인수로 전달합니다. hyperfine.exe의 실제 위치에 맞춰 경로를 바꾸세요.
& "..\hyperfine-v1.20.0-x86_64-pc-windows-msvc\hyperfine.exe" --warmup 1 --runs 5 ".\demo-fast.cmd" ".\demo-slow.cmd"

--warmup 1은 각 명령을 사전 실행하고, --runs 5는 측정 반복 수입니다. demo-fast.cmd는 간단한 출력만 수행하고 demo-slow.cmd는 짧게 대기합니다. 서로 다른 프로그램의 실제 성능 순위를 증명하는 예제가 아닙니다. Windows 프로세스 시작 비용과 시스템 부하가 포함됩니다. 공식 사용법

3. 자신의 작업에 적용

빌드 도구를 비교할 때는 동일 입력, 동일 작업 폴더, 동일 출력 상태에서 실행하세요. 파일 캐시나 증분 빌드 때문에 첫 실행과 이후 실행이 달라질 수 있습니다. 비교하려는 조건을 먼저 정하고 --warmup과 --prepare를 사용합니다. --prepare 명령은 매 측정 전에 실행되므로 삭제·정리 명령을 넣을 때 경로를 확인하세요. 측정 결과를 나중에 분석하려면 --export-json results.json을 추가합니다. 출력 파일에는 실행 명령 문자열이 들어갈 수 있으니 공유 전에 내부 경로를 확인하세요. 공식 기능·JSON 출력 안내

4. 문제 해결

원본 및 이용 조건: hyperfine 저장소, MIT 고지문, Apache-2.0 고지문.