워로디스

Pandas. 데이터프레임 출력 폭(Width) 조절 방법 본문

Data Science/Pandas

Pandas. 데이터프레임 출력 폭(Width) 조절 방법

워로디스 2026. 8. 2. 13:39

Pandas에서 데이터프레임을 출력할 때 줄바꿈이 발생하는 것은 콘솔창의 기본 출력 너비가 제한되어 있기 때문입니다. 이를 해결하기 위해 Pandas의 set_option 함수를 사용하여 출력 설정을 변경할 수 있습니다.

1. 출력 너비(Width) 확장

데이터프레임이 줄바꿈 없이 가로로 넓게 출력되도록 전체 출력 폭을 늘리는 설정입니다. 숫자는 콘솔에 표시될 수 있는 문자(Character)의 개수를 의미합니다.

import pandas as pd

# 콘솔 출력 너비를 1000자로 확장 (필요에 따라 숫자 조절 가능)
pd.set_option('display.width', 1000)

2. 최대 출력 컬럼 수(Max Columns) 해제

너비를 늘려도 전체 컬럼 수가 많을 경우, 줄바꿈 대신 중간 컬럼이 ...으로 생략되어 출력될 수 있습니다. 모든 컬럼을 생략 없이 가로로 출력하려면 최대 컬럼 수 설정도 함께 조정해야 합니다.

# 컬럼 생략 없이 모두 출력 (None으로 설정)
pd.set_option('display.max_columns', None)

3. 특정 구간에서만 임시로 적용하기 (권장)

전역(Global) 설정을 변경하지 않고 특정 데이터프레임을 출력할 때만 일회성으로 설정을 적용하고 싶다면 option_context를 사용하는 것이 안전합니다.

# with문 블록 안에서만 넓은 너비와 전체 컬럼 출력이 적용됨
with pd.option_context('display.width', 1000, 'display.max_columns', None):
    print(df)

참고: 기본값 복구 방법

설정을 변경한 후 다시 기본 상태로 되돌리고 싶다면 reset_option을 사용합니다.

# 특정 설정만 초기화
pd.reset_option('display.width')
pd.reset_option('display.max_columns')

# display 관련 모든 설정을 한 번에 초기화
pd.reset_option('display.*')
반응형