Git Bash python3 가 Python 한 줄만 찍고 끝날 때

먼저 결론

겪은 일: Git Bash 에서 python3 - <<'EOF' 로 파일을 고치는 스크립트를 두 번 돌렸는데 아무것도 안 바뀌었습니다. 출력은 "Python" 한 단어뿐이었습니다.

원인: 그 PC 의 python3 는 WindowsApps 폴더에 있는 스토어 설치 안내용 껍데기입니다. 스크립트를 읽지 않고 종료 코드 49 로 끝납니다.

이렇게 쓴다: 로컬에서는 python 을 부르고, 한글이 든 스크립트는 파일로 저장해 PYTHONUTF8=1 python 파일 로 돌립니다. 끝에 "ok" 를 찍어 확인한 뒤에만 다음 명령으로 갑니다.

고쳤다는 커밋만 남았다

스크립트 뒤에는 줄을 바꿔 git commit 을 이어 두었습니다. 파이썬 단계가 아무 일도 안 했는데 커밋은 그대로 돌았고, 커밋 메시지에는 "고쳤다"가 남았습니다. 나중에 grep 으로 파일을 열어 보고서야 바뀐 것이 없다는 것을 알았습니다.

"Python" 한 단어는 오류처럼 보이지 않습니다. 흔한 출력 한 줄처럼 지나가기 쉬워서, 같은 일을 두 번 겪었습니다.

다시 재 본 python3 의 정체

이 글을 쓰면서 같은 PC 에서 여러 방법으로 다시 불러 보았습니다.

which python3
# /c/Users/사용자/AppData/Local/Microsoft/WindowsApps/python3
which python
# /c/Users/사용자/AppData/Local/Programs/Python/Python39/python

python3 -c "print(1)"; echo "exit=$?"
python3 -c "print(1)" 2>/dev/null; echo "exit=$?"
부른 방법 화면 종료 코드
python3 -c "print(1)" Python 49
python3 - <<'EOF' (heredoc) Python 49
echo 'print(1)' | python3 (파이프) 아무것도 없음 49
python3 --version Python 49
표준 오류를 버리고 -c 아무것도 없음 49

마지막 줄이 눈여겨볼 점입니다. "Python" 은 표준 출력이 아니라 표준 오류로 나옵니다. 출력을 파일로 받거나 오류를 버리는 스크립트에서는 그 한 단어마저 보이지 않습니다. 파이프로 넣으면 표준 출력과 표준 오류를 합쳐도 0바이트였습니다(세 번 재도 같았습니다). heredoc 은 "Python" 이 찍히는데 파이프는 그 한 단어마저 안 나와 가장 알아차리기 어렵습니다.

종료 코드는 0 이 아니었습니다. 그러니 && 로 이었다면 커밋은 돌지 않았을 것입니다. 실제로 python3 -c "print(1)" && echo ... 로 이어 보니 뒤의 echo 는 돌지 않았습니다. 사고는 줄바꿈이나 ; 로 이어서 앞 명령의 실패를 보지 않았기 때문에 났습니다.

python 으로 바꾸면 만나는 한글 문제

진짜 파이썬은 python(3.9) 이었습니다. 그런데 이것으로 바꾸자 표준 입력으로 넣은 한글 스크립트가 SyntaxError: Non-UTF-8 code 로 거부됐습니다. 표준 입력을 cp949 로 읽기 때문입니다. 이번에 짧은 한글 두 줄로 다시 재 보니 오류 없이 돌았지만 한글이 깨져 찍혔습니다. 어느 쪽이든 믿을 수 없는 길입니다.

돌린 방법 본 결과
python - 에 한글 heredoc 기록: Non-UTF-8 오류, 다시 잼: 한글 깨짐
PYTHONUTF8=1 python - 한글 정상
파일로 저장, -X utf8, 한글이 수백 자인 긴 줄 기록: Non-UTF-8 code ... on line N
Bash heredoc 에 한글과 따옴표가 섞임 기록: 파일 끝이 잘려 unterminated string literal

긴 줄 오류는 파일 첫 줄에 인코딩 선언을 넣으니 사라졌습니다. 그래서 처음부터 넣고 시작합니다. 파워셸에서 한글이 깨지는 다른 경우는 파워셸 5.1 한글 깨짐에 따로 정리했습니다.

지금 쓰는 순서

  1. 로컬에서는 python 만 씁니다. 윈도우 10 설정의 앱 화면에 있는 "앱 실행 별칭"에서 python3 껍데기를 끌 수도 있습니다.
  2. 한글이 든 스크립트는 heredoc 으로 넣지 않고 파일로 저장합니다. heredoc 은 영문만 든 짧은 것에만 씁니다.
  3. 고치는 스크립트 끝에 확인 줄을 둡니다. 그 줄이 출력에 있을 때만 커밋합니다.
# -*- coding: utf-8 -*-
import pathlib
p = pathlib.Path("page.html")
s = p.read_text(encoding="utf-8")
s = s.replace("옛 문구", "새 문구")
p.write_text(s, encoding="utf-8")
print("ok", len(s))
PYTHONUTF8=1 python fix.py | grep -q '^ok' && git commit -am "문구 수정"

덤으로 하나 더 있습니다. 스크립트 이름을 con.py 로 지으면 con 이 윈도우 예약어(콘솔 장치)라서 python con.py 가 파일을 못 읽고 대화형 창(>>>)으로 멈춥니다. aux, nul, prn, com1 도 같습니다.

검사를 통과했다는 표시만 믿다가 실제로는 깨져 있던 다른 경우는 py_compile 검사를 통과했는데 라이브가 죽었을 때에 적었습니다.

확인한 환경 값
PC Windows 10 Pro, Git Bash (bash 5.2.37)
파이썬 python = 3.9.13, python3 = WindowsApps 껍데기
처음 겪은 날 2026년 10월 2일, 3일
다시 잰 날 2026년 10월 15일

이 글의 내용은 2026년 10월 21일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.