bat 0.26.1 한국어 설명서

대상 사용자: 프로그래머. bat은 터미널에서 소스 파일을 구문 강조와 줄 번호로 읽는 명령줄 유틸리티입니다. 긴 파일의 특정 구간을 확인하거나 장식 없는 내용을 출력할 때 유용합니다. 이번 자료는 bat 0.26.1 / Windows x64를 기준으로 작성했으며 명령은 PowerShell용입니다.

1. 다운로드와 첨부파일 구성

이 글 아래의 첨부파일에서 공식 실행파일 ZIP과 한국어 설명서·실습 ZIP을 각각 받으세요. 다른 CPU·운영체제용 파일은 공식 v0.26.1 릴리스에서 선택합니다. 버전 확인일은 2026-09-24이며, 이 글은 해당 버전을 고정해 검증했습니다.

첨부파일	내용
`bat-v0.26.1-x86_64-pc-windows-msvc.zip`	공식 원본 ZIP. bat.exe, 라이선스, README, man 페이지, 셸 자동완성 파일
`bat-0.26.1-korean-guide-practice.zip`	한국어 HTML·Markdown 설명서, 가상 Python·JSON 샘플, 예상 결과, PowerShell 검증 스크립트

공식 ZIP은 내려받은 바이트 그대로 제공하며 GitHub 릴리스 자산의 SHA-256과 대조했습니다. 프로젝트가 제공하는 MIT/Apache-2.0 라이선스와 포함된 저작권 표시를 그대로 보존했습니다. 공식 MIT 라이선스, Apache-2.0 라이선스를 확인하세요. 직접 작성한 설명서·실습은 CC0-1.0이며 원본 프로그램에는 원래 라이선스가 적용됩니다.

2. 설치: 압축을 풀고 실행 경로 확인

공식 ZIP 전체를 C:\Tools\bat에 풉니다. 일반적인 압축 해제 결과에서는 그 안에 bat-v0.26.1-x86_64-pc-windows-msvc 폴더가 생깁니다. bat.exe만 따로 옮기지 말고 라이선스와 문서도 보관하세요.
설명서·실습 ZIP은 별도의 작업 폴더에 풉니다. 그 폴더에서 PowerShell을 엽니다. samples와 verify-practice.ps1이 보여야 합니다.
아래 경로가 실제 bat.exe 위치와 같은지 확인하고 버전을 출력합니다. 압축 프로그램이 폴더를 하나 더 만들었다면 경로를 조정하세요.

$bat = 'C:\Tools\bat\bat-v0.26.1-x86_64-pc-windows-msvc\bat.exe'

Test-Path -LiteralPath $bat

& $bat --version

예상 결과는 True, bat 0.26.1 (979ba22)입니다. 괄호 안은 이 공식 빌드의 커밋 식별자입니다. 여기서는 PATH 등록이나 관리자 권한 없이 절대 경로를 사용합니다. 공식 Windows 안내는 Visual C++ Redistributable을 요구합니다. 관련 DLL이 없다는 오류가 나면 Microsoft 공식 런타임 안내의 x64 패키지를 확인하세요. 이 자료에는 Microsoft 런타임 설치파일을 포함하지 않았습니다. bat 공식 설치 안내

3. 소스 구문 강조와 줄 번호

실습 파일 samples\sensor.py는 가상의 센서 값을 출력하는 짧은 Python 코드입니다. 다음 명령은 파일을 표시합니다. Python 코드를 실행하는 명령이 아닙니다.

& $bat --no-config --paging=never --style=numbers .\samples\sensor.py

터미널에서 6줄의 소스와 줄 번호를 확인하세요. --no-config는 사용자 설정 파일의 영향을 제외하고, --paging=never는 별도 페이지 뷰어를 띄우지 않습니다. 설정 환경변수까지 모두 초기화하는 옵션은 아니므로 개인 BAT_* 설정이 있다면 아래의 명시적 옵션과 도움말을 함께 확인하세요.

구문을 직접 지정하고 싶다면 다음처럼 파일 확장자와 관계없이 Python으로 보여 줄 수 있습니다. 색상은 터미널 지원과 출력 연결 방식에 따라 달라집니다.

& $bat --no-config --paging=never --language=python .\samples\sensor.py

4. 필요한 줄만 보기와 장식 없는 출력

다음 명령은 3~5행만 출력합니다. --plain은 장식을 없애며, 색상과 페이징도 명시적으로 끕니다.

& $bat --no-config --paging=never --plain --color=never --line-range 3:5 .\samples\sensor.py

예상 결과:

return raw / 16

print(to_celsius(400))

빈 줄도 원본의 행 번호에 포함됩니다. 프로그램 사이에 내용을 전달할 때는 화면용 줄 번호나 색상 제어 문자가 섞이지 않도록 아래처럼 출력 조건을 고정하세요. 이 명령은 JSON을 보여 줄 뿐 JSON 문법이나 데이터 스키마를 검사하지 않습니다.

& $bat --no-config --paging=never --plain --color=never .\samples\device.json

예상 결과는 {"device":"demo-01","temperature_c":25,"ok":true}입니다. 파일을 그대로 복제하는 목적이라면 파일 복사 기능을 사용하세요. PowerShell의 텍스트 파이프·리디렉션은 인코딩이나 줄바꿈에 영향을 줄 수 있습니다.

5. 실습 자동 점검

첨부한 스크립트를 텍스트 편집기로 확인한 뒤 아래 명령을 실행합니다. 스크립트는 샘플을 읽어 전체 내용·부분 행·줄 번호·버전·없는 파일의 오류를 확인하고, 입력 샘플이 변경되지 않았는지 해시를 비교합니다.

.\verify-practice.ps1 -BatPath $bat

정상이면 PASS: version, plain, range, JSON, numbers, missing file, unchanged samples가 출력됩니다. 회사나 PC의 실행 정책이 스크립트를 막으면 정책을 바꾸지 않아도 됩니다. 2~4절의 명령을 직접 입력하고 expected-results.txt와 비교하세요.

6. 문제 해결

증상	확인할 내용
bat이 명령으로 인식되지 않음	`$bat`의 실제 경로와 `Test-Path` 결과를 확인하고 `& $bat`로 호출합니다.
실행파일을 더블클릭하면 창이 사라짐	PowerShell에서 파일 경로를 인수로 전달합니다. GUI 편집기가 아닙니다.
화면이 멈춘 것처럼 보임	`--paging=never`를 지정합니다. 기본 페이저가 동작한 상태라면 해당 페이저의 종료 키를 사용합니다.
파이프로 보낼 때 색상·줄 번호가 사라짐	비대화형 출력의 자동 동작입니다. 화면 검증용으로 강제하려면 `--decorations=always --color=always`를 지정합니다. 데이터 전달에는 강제 장식을 사용하지 마세요.
x64에서 DLL 누락, ARM PC에서 실행 문제	실제 CPU용 공식 자산을 선택하고 Microsoft의 해당 아키텍처 런타임 안내를 확인합니다.
한글이 깨짐	먼저 원본이 UTF-8인지와 터미널의 인코딩을 확인합니다. 이번 기능 시험은 ASCII 샘플 기준이며 모든 레거시 인코딩을 검증한 것은 아닙니다.
예제와 표시가 다름	버전·입력 파일·현재 폴더와 `BAT_*` 개인 설정을 확인합니다. `--no-config --paging=never --help`로 사용 중인 실행파일의 옵션을 읽습니다.

7. 검증 범위와 공식 문서

Windows x64에서 첨부한 공식 실행파일의 버전, 장식 없는 전체 내용, 3~5행 범위, JSON 출력, 줄 번호, ANSI 색상 생성, 없는 파일의 실패 종료와 샘플 불변성을 검사했습니다. PowerShell 검증 스크립트도 실행했습니다. ARM·32비트·macOS·Linux 실행 및 모든 터미널의 색상 표현은 시험하지 않았습니다.

공식 자료: 릴리스·다운로드, 원본 ZIP 직접 받기, 고정 버전 README. 첨부 ZIP 안의 bat.1과 bat.exe --no-config --paging=never --help에도 상세 옵션이 있습니다.