터미널 출력이 겹쳐 보일 때 — 맥 터미널 줄바꿈 설정법

맥 터미널 줄바꿈 설정으로 화면에 출력이 겹치는 불편함을 해소하세요. 단계별 명령어와 프로필 편집 방법을 자세히 안내해 드립니다. ★맥 터미널 줄바꿈

맥 터미널 줄바꿈 설정 방법을 찾고 계신가요, 긴 로그가 출력될 때 줄바꿈이 되지 않아 화면이 뒤섞이고 작업 내용을 확인조차 하기 힘든 상황 때문에 답답함을 겪고 계신가요. 이 문제는 주로 터미널의 프롬프트 설정이나 시스템의 줄바꿈 문자 처리 방식이 기본값과 달라졌기 때문에 발생합니다. 특히 개발자나 시스템 관리자에게 터미널은 가장 기본적인 작업 도구인데, 화면이 깨져버리면 로그 분석은커녕 간단한 명령어 입력조차 불가능해져 큰 스트레스를 유발합니다. 이 글에서는 프롬프트 변수 수정부터 시스템 설정 파일 변경까지, 맥 터미널 줄바꿈 설정 방법을 실제 사례 3가지와 패턴 분석을 통해 구체적으로 해결합니다. 단순히 명령어를 나열하는 것을 넘어, 왜 이런 현상이 발생하는지 그 원인을 파고들어 근본적인 해결책을 제시합니다.

함께 보면 좋은 글: 맥 부팅 안 될 때 복구 모드 진입 5단계 정리

이 글의 핵심

- 프롬프트(PS1) 변수의 비출력 문자 처리가 줄바꿈 겹침의 주원인입니다.
- stty 명령어와 .inputrc 설정으로 터미널의 동작 방식을 제어합니다.
- 실제 사용자 후기와 명령어를 통해 즉시 적용 가능한 해결책을 제공합니다.
- 맥 터미널의 창 설정과 단축키를 활용한 화면 관리법을 정리합니다.

한 줄 답변

맥 터미널에서 출력이 겹쳐 보일 경우, 터미널 환경설정의 ‘줄바꿈 모드’와 ‘컬럼 수’를 적절히 조정하면 즉시 깔끔하게 정렬됩니다.

3단계
설정 절차
5초
시간 절감
80컬럼
기본 라인 길이
무료
비용
2026년 07월 07일· 10분 읽기· Mebys Blog

사례 1. 프롬프트 설정 오류로 인한 줄바꿈 겹침 현상

많은 사용자가 터미널을 꾸미기 위해 .zshrc.bash_profile 파일을 수정하다가 화면 깨짐 현상을 경험합니다. 특히 macOS 15.2 Sequoia와 같은 최신 환경에서도 기본 쉘인 Zsh의 프롬프트 설정을 잘못 다루면 긴 명령어를 입력하거나 출력 결과가 길어질 때 텍스트가 덮어씌워지듯 출력됩니다. 이는 색상이나 글꼴 스타일을 적용하는 ANSI 이스케이프 시퀀스가 터미널에 "글자 수"로 잘못 인식되어 커서 위치 계산을 어지럽히기 때문입니다. 사용자 입장에서는 입력한 글자가 사라지거나 이전 줄의 내용 위로 겹쳐 써지는 혼란스러운 경험을 하게 됩니다.

예를 들어, 사용자가 프롬프트에 초록색 경로를 표현하기 위해 별도의 처리 없이 이스케이프 코드를 넣었다면, 터미널은 그 코드를 화면에 그려지는 글자가 아니라 이동해야 할 커서의 거리로 계산합니다. 결과적으로 명령어가 입력되어야 할 위치가 실제 화면 위치와 달라져 겹쳐 보이게 됩니다. 실제로 한 개발자는 export PS1='\e[0;32m\u@\h \w\e[m $ '와 같이 설정했다가 긴 로그를 확인할 때마다 줄이 서로 엉키는 문제를 겪었습니다. 이는 터미널이 색상 코드 \e[0;32m 등을 실제 화면 폭을 차지하는 문자로 인식하여 래핑(wrapping) 지점을 잘못 잡기 때문입니다.

또한, 최근 유행하는 'Powerlevel10k'나 복잡한 테마를 사용할 때도 이러한 문제가 빈번히 발생합니다. 이 테마들은 특수 문자나 아이콘을 많이 사용하는데, 이들이 폰트 렌더링 과정에서 차지하는 실제 폭과 터미널이 인식하는 문자 폭이 일치하지 않을 경우 눈에 보이지 않는 공백이나 겹침이 발생합니다. 특히 한글과 영문이 혼용된 상태에서 긴 명령어를 입력할 때 이런 현상은 더욱 두드러집니다.

해결 단계: 프롬프트 변수 수정

이를 해결하려면 비출력 문자, 즉 색상이나 커서 이동을 담당하는 코드 앞뒤를 대괄호로 감싸서 터미널이 이를 길이 계산에서 제외하도록 해야 합니다. Bash에서는 \[\]를 사용하고, Zsh에서는 %{%}를 사용해야 합니다. 이 설정이 제대로 적용되지 않으면 긴 줄을 넘어갈 때마다 화면이 뒤죽박죽이 됩니다. 다음은 이를 단계별로 해결하는 방법입니다.

1

현재 설정 백업하기

설정 파일을 수정하기 전에 cp ~/.zshrc ~/.zshrc_backup 명령어를 사용해 현재 설정 파일을 반드시 백업해 둡니다. 잘못된 수정으로 터미널 진입 자체가 불가능해질 경우를 대비한 안전장치입니다.

2

설정 파일 열기

홈 디렉터리의 .zshrc 파일을 텍스트 에디터나 vi 편집기로 엽니다. 예를 들어 vi ~/.zshrc를 입력하여 편집 모드로 진입합니다.

3

이스케이프 코드 감싸기

색상이나 스타일을 지정하는 \e[... 또는 \033[...로 시작하는 코드를 찾아 Zsh 문법인 %{...%}로 감쌉니다. 예를 들어 \e[0;32m%{\e[0;32m%}로 변경해야 합니다.

4

PROMPT 변수 확인하기

최신 Zsh에서는 PS1 대신 PROMPT 변수를 사용하는 경우가 많습니다. 설정 파일 내에서 PROMPT=로 시작하는 줄을 찾아 위와 같은 방법으로 비출력 문자를 처리해 줍니다.

5

저장 및 편집기 종료

vi 에디터의 경우 :wq를 입력해 저장하고 종료합니다.

6

적용 및 확인

source ~/.zshrc 명령어를 입력해 변경 사항을 즉시 적용합니다. 이후 아주 긴 문자열을 입력해 보거나 echo "very long string..." 명령어로 줄바꿈이 정상적으로 되는지 확인합니다.

7

복구 방법 숙지

만약 수정 후 화면이 이상해진다면 source ~/.zshrc_backup 명령어로 백업 파일을 불러와 즉시 복구할 수 있습니다.

실제 사용자들은 이 문제를 해결하기 위해 복잡한 스크립트를 작성하기도 합니다. 한 사용자는 클리엔 서비스 판에서 "거기에서 위의 이미지처럼 .*(정규식 사용) 를 클릭하여 활성화 하고, 위의 입력항목(바꿀대상)에 \n 을 입력하시고, 아래 입력항목(바꿀항목)에 공백 하나 입력합니다. ( 줄바꿈(\n)을 공백으로 바꾸기 하는 의미입니다.) 그렇게 ..."라고 언급하며, 이미 꼬여버린 텍스트를 텍스트 에디터에서 정규식을 사용해 해결하는 방법을 공유하기도 했습니다. (clien.net) 하지만 근본적인 해결을 위해서는 위의 단계처럼 프롬프트 변수를 올바르게 수정하는 것이 필수적입니다.

참고
Apple 공식 개발자 문서와 Zsh 매뉴얼에 따르면, 프롬프트 내의 비출력 시퀀스는 반드시 %{ %} 또는 \[ \]로 묶어야 터미널의 라인 에디터가 커서 위치를 올바르게 계산할 수 있습니다. 이를 통해 긴 명령어 입력 시 발생하는 시각적 혼란을 방지할 수 있습니다.
맥 터미널 줄바꿈 설정 방법

Photo by Brian James on Pexels

사례 2. stty 설정과 제어 문자 문제 해결

프롬프트 설정이 올바르더라도, 서버 접속이나 특정 프로그램 실행 중에 줄바꿈이 깨지는 경우가 있습니다. 이는 터미널의 "터미널 라인 설정"을 담당하는 stty 명령어의 설정이 꼬였기 때문일 가능성이 높습니다. 특히 맥 터미널에서 리눅스 서버로 접속하거나, Docker 컨테이너 내부에서 작업할 때 호스트와 클라이언트 간의 줄바꿈 문자(CR, LF) 처리 방식이 달라 발생합니다.

가장 흔한 현상은 엔터키(Enter)를 쳤을 때 줄바꿈은 되지만 커서가 줄의 맨 앞으로 이동하지 않아 계속해서 옆으로 써지는 현상입니다. 이는 "Carriage Return"(CR)이 누락되었을 때 발생합니다. stty -a 명령어를 통해 현재 설정을 확인해 보면 onlcr 옵션이 꺼져 있는 경우가 많습니다. 이 옵션은 출력 시 라인 피드(LF, \n)를 캐리지 리턴(CR, \r)과 라인 피드의 조합(CRLF)으로 변환해 주는 역할을 합니다. 이 설정이 맞지 않으면 화면 상의 줄바꿈 위치가 꼬이게 됩니다.

또 다른 시나리오는 원격 서버 접속 시 발생합니다. 로컬 맥 터미널은 정상적인데, SSH로 접속한 서버에서만 명령어가 한 줄로 쭉 이어지거나 입력 프롬프트가 덮어씌워지는 경우입니다. 이는 서버의 stty 설정이 터미널의 폭을 인식하지 못하거나, TERM 환경 변수가 잘못 설정되었기 때문일 수 있습니다. 예를 들어, 맥에서는 xterm-256color를 기본으로 사용하지만, 구형 서버는 이를 제대로 처리하지 못해 줄바꿈 문자를 잘못 해석하기도 합니다.

해결

동영상으로 보는 맥 터미널 줄바꿈 설정 방법

글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.

▶ YouTube에서 “맥 터미널 줄바꿈 설정 방법” 영상 보기

자주 묻는 질문

Q. 맥 터미널에서 줄바꿈이 겹쳐 보이는 이유는 무엇인가요?

A. 터미널이 현재 창 너비보다 긴 명령어 출력을 자동으로 줄바꿈하지 못하면 화면에 겹쳐 보일 수 있습니다. 특히, 프롬프트가 길거나 스크립트 출력이 긴 경우 이런 현상이 나타납니다.

Q. 터미널 줄바꿈을 자동으로 켜는 방법은?

A. 터미널 메뉴에서 'Shell' → 'Use Option as Meta key'를 해제하고, 'Preferences' → 'Profiles' → 'Text' 탭에서 'Wrap lines' 옵션을 체크하면 자동 줄바꿈이 활성화됩니다.

Q. 줄바꿈이 제대로 안 될 때 단축키로 강제 줄바꿈을 할 수 있나요?

A. 네, 현재 커서 위치에서 강제 줄바꿈을 하고 싶다면 `Ctrl + A` 로 라인 시작으로 이동한 뒤 `Ctrl + K` 로 라인을 삭제하고 다시 입력하면 됩니다. 또한 `Ctrl + L` 로 화면을 깨끗이 정리할 수 있습니다.

Q. 줄바꿈 설정을 적용했는데도 여전히 겹쳐 보이면 어떻게 해야 하나요?

A. 터미널 프로필을 재시작하거나, 변경한 설정이 현재 세션에 적용되지 않을 수 있으니 터미널을 완전히 종료하고 다시 열어 보세요. 그래도 문제가 지속되면 `.zshrc` 혹은 `.bash_profile`에 `export COLUMNS=$(tput cols)` 를 추가해 화면 너비를 강제로 재설정할 수 있습니다.

매주 IT 실전 가이드 받아보세요

맥OS·크롬·자동화·AI 도구 주 1회 큐레이션. 광고·스팸 없는 깔끔한 메일.

무료 구독하기

M
Mebys Blog
맥OS · 크롬 · 자동화 · AI 도구 가이드


댓글 남기기

Mebys Blog에서 더 알아보기

지금 구독하여 계속 읽고 전체 아카이브에 액세스하세요.

계속 읽기