파이썬 엑셀 라이브러리 openpyxl 완전정복 - 모듈·클래스·함수 총정리 (2026) 📊

pip install openpyxl
# 이미지 삽입 기능을 쓰려면 Pillow도 필요해요
pip install pillow

import openpyxl
print(openpyxl.__version__)   # 3.1.5

from openpyxl import Workbook

wb = Workbook()      # 새 통합 문서 (기본 시트 1개 자동 생성)
ws = wb.active       # 현재 활성 시트
wb.save("새파일.xlsx")

from openpyxl import load_workbook

wb = load_workbook("기존파일.xlsx")

# 수식이 아니라 값만 읽고 싶을 때
wb = load_workbook("보고서.xlsx", data_only=True)

# 매크로 파일을 열고 저장할 때
wb = load_workbook("매크로.xlsm", keep_vba=True)

ws = wb.active                       # 활성 시트
ws2 = wb.create_sheet("판매")        # 맨 뒤에 새 시트
ws3 = wb.create_sheet("요약", 0)     # 0번 인덱스(맨 앞)에 삽입
sheet = wb["판매"]                   # 이름으로 접근
print(wb.sheetnames)                 # ['요약', 'Sheet', '판매']

wb.remove(wb["판매"])                # 삭제
new = wb.copy_worksheet(wb["요약"])  # 복사 (서식까지 복제)

ws.title = "성적표"
ws.sheet_properties.tabColor = "1072BA"   # 탭 색상
print(ws.max_row, ws.max_column, ws.dimensions)

# 방법 1) 엑셀 좌표로
ws["A1"] = "이름"
print(ws["A1"].value)          # 이름

# 방법 2) 행·열 번호로 (1부터 시작!)
ws.cell(row=1, column=2, value="점수")
print(ws.cell(row=1, column=2).value)   # 점수

# 한 줄씩 추가 (가장 편함)
ws.append(["철수", 90])
ws.append(["영희", 85])

# 범위로 접근
for row in ws["A1:B3"]:
    for cell in row:
        print(cell.coordinate, cell.value)

# 행 단위 순회
for row in ws.iter_rows(min_row=2, max_col=2, values_only=True):
    이름, 점수 = row
    print(이름, 점수)

# 열 단위 순회
for col in ws.iter_cols(min_col=1, max_col=2, values_only=True):
    print(col)

from openpyxl.utils import (
    get_column_letter, column_index_from_string, range_boundaries,
)
# coordinate_from_string만 하위 모듈에서 가져와요 (openpyxl.utils에서 직접 import하면 ImportError!)
from openpyxl.utils.cell import coordinate_from_string

print(get_column_letter(1))            # A
print(get_column_letter(27))           # AA
print(column_index_from_string("B"))   # 2
print(column_index_from_string("AA"))  # 27
print(coordinate_from_string("C5"))    # ('C', 5)
print(range_boundaries("A1:C3"))       # (1, 1, 3, 3)

from openpyxl.styles import (
    Font, PatternFill, GradientFill, Border, Side,
    Alignment, Protection, NamedStyle,
)

ws["A1"].font = Font(
    name="맑은 고딕",   # 글꼴
    size=12,           # 크기
    bold=True,         # 굵게
    italic=False,      # 기울임
    underline="single",# 밑줄 (single/double)
    strike=False,      # 취소선
    color="FFFFFF",    # 글자색 (RRGGBB)
)

ws["A1"].fill = PatternFill(
    fill_type="solid",   # 채우기 방식 (solid가 일반적)
    fgColor="4F81BD",    # 채울 색 (RRGGBB)
)

thin = Side(style="thin", color="000000")   # 선 하나 정의
ws["A1"].border = Border(left=thin, right=thin, top=thin, bottom=thin)

ws["A1"].alignment = Alignment(
    horizontal="center",  # left/center/right/justify
    vertical="center",    # top/center/bottom
    wrap_text=True,       # 자동 줄바꿈
    text_rotation=0,      # 글자 회전 각도
)

ws["B2"].value = 12345.678
ws["B2"].number_format = "#,##0.00"   # 12,345.68

header = NamedStyle(name="헤더")
header.font = Font(bold=True, color="FFFFFF")
header.fill = PatternFill("solid", fgColor="808080")
wb.add_named_style(header)

ws["A1"].style = "헤더"   # 이름으로 적용

ws.column_dimensions["A"].width = 20   # A열 너비
ws.row_dimensions[1].height = 30       # 1행 높이

ws.merge_cells("A1:C1")                 # 문자열 범위
ws["A1"] = "병합된 제목"                # 값은 좌상단 셀에만!
ws.unmerge_cells("A1:C1")

# 행·열 번호로도 가능
ws.merge_cells(start_row=1, start_column=1, end_row=1, end_column=3)

ws.freeze_panes = "A2"   # 1행 고정 (스크롤해도 헤더가 안 사라짐)
ws.freeze_panes = "B2"   # 1행 + A열 동시 고정

ws.column_dimensions["C"].hidden = True   # C열 숨김
ws.auto_filter.ref = "A1:E1"              # 헤더에 필터 버튼

ws["C2"] = "=A2+B2"
ws["C3"] = "=SUM(A2:B2)"
ws["C4"] = "=AVERAGE(A2:A10)"

from openpyxl.chart import BarChart, Reference

chart = BarChart()
chart.title = "학생별 총점"
chart.type = "col"          # col=세로막대, bar=가로막대
chart.style = 10

# 데이터 범위 (헤더 포함)
values = Reference(ws, min_col=5, min_row=1, max_row=4)
# 카테고리(X축 라벨)
cats = Reference(ws, min_col=1, min_row=2, max_row=4)

chart.add_data(values, titles_from_data=True)
chart.set_categories(cats)
ws.add_chart(chart, "H2")   # H2 위치에 삽입

from openpyxl.drawing.image import Image

img = Image("logo.png")
img.width = 120     # 픽셀 (선택)
img.height = 60
ws.add_image(img, "A1")   # A1 위치에 삽입
wb.save("이미지포함.xlsx")

from openpyxl.worksheet.datavalidation import DataValidation

# 드롭다운 목록
dv = DataValidation(type="list", formula1='"사과,바나나,포도"', allow_blank=True)
ws.add_data_validation(dv)
dv.add("A2:A10")   # 이 범위에 드롭다운 적용

# 1~100 사이 정수만 허용
dv2 = DataValidation(type="whole", operator="between", formula1=1, formula2=100)
ws.add_data_validation(dv2)
dv2.add("B2:B10")

from openpyxl.formatting.rule import ColorScaleRule, CellIsRule, DataBarRule
from openpyxl.styles import PatternFill

# 1) 색조(2색 스케일): 낮으면 빨강 → 높으면 초록
ws.conditional_formatting.add(
    "B2:B10",
    ColorScaleRule(start_type="min", start_color="F8696B",
                   end_type="max", end_color="63BE7B"),
)

# 2) 특정 값보다 크면 노란 배경
ws.conditional_formatting.add(
    "B2:B10",
    CellIsRule(operator="greaterThan", formula=["80"],
               fill=PatternFill("solid", fgColor="FFFF00")),
)

# 3) 데이터 막대
ws.conditional_formatting.add(
    "C2:C10",
    DataBarRule(start_type="min", end_type="max", color="638EC6"),
)

from openpyxl.worksheet.table import Table, TableStyleInfo

tbl = Table(displayName="성적표", ref="A1:E4")   # displayName은 공백 없이!
tbl.tableStyleInfo = TableStyleInfo(
    name="TableStyleMedium9",   # 내장 스타일 이름
    showRowStripes=True,        # 줄무늬
)
ws.add_table(tbl)

from openpyxl.comments import Comment

ws["A1"].comment = Comment("이건 메모예요", "Mojangcam")
ws["A2"].value = "블로그"
ws["A2"].hyperlink = "https://mojangcam.tistory.com"
ws["A2"].style = "Hyperlink"   # 파란 밑줄 스타일

# 읽기: 메모리 적게, 순차 접근만
wb = load_workbook("대용량.xlsx", read_only=True)
for row in wb.active.iter_rows(values_only=True):
    ...
wb.close()

# 쓰기: append로만 추가, 서식 최소
from openpyxl import Workbook
wb = Workbook(write_only=True)
ws = wb.create_sheet()
for i in range(100000):
    ws.append([i, i*2])
wb.save("대용량출력.xlsx")

ws.print_area = "A1:E20"
ws.page_setup.orientation = "landscape"   # 가로

# openpyxl 3.1.5 / Python 3.8+
from openpyxl import Workbook, load_workbook
from openpyxl.styles import Font, PatternFill, Border, Side, Alignment
from openpyxl.chart import BarChart, Reference
from openpyxl.utils import get_column_letter

# 1) 통합 문서 + 시트
wb = Workbook()
ws = wb.active
ws.title = "성적표"

# 2) 헤더 + 데이터
headers = ["이름", "국어", "영어", "수학", "총점"]
ws.append(headers)
data = [
    ["김철수", 90, 85, 95],
    ["이영희", 88, 92, 100],
    ["박민수", 75, 80, 70],
]
for row in data:
    ws.append(row + [sum(row[1:])])   # 총점 자동 계산

# 3) 헤더 스타일
header_font = Font(bold=True, color="FFFFFF", size=12)
header_fill = PatternFill("solid", fgColor="4F81BD")
thin = Side(style="thin", color="999999")
border = Border(left=thin, right=thin, top=thin, bottom=thin)
center = Alignment(horizontal="center", vertical="center")
for col in range(1, len(headers) + 1):
    c = ws.cell(row=1, column=col)
    c.font, c.fill, c.border, c.alignment = header_font, header_fill, border, center

# 4) 열 너비 + 틀 고정
for col in range(1, len(headers) + 1):
    ws.column_dimensions[get_column_letter(col)].width = 12
ws.freeze_panes = "A2"

# 5) 막대 차트 (이름별 총점)
chart = BarChart()
chart.title = "학생별 총점"
chart.type = "col"
values = Reference(ws, min_col=5, min_row=1, max_row=1 + len(data))
cats = Reference(ws, min_col=1, min_row=2, max_row=1 + len(data))
chart.add_data(values, titles_from_data=True)
chart.set_categories(cats)
ws.add_chart(chart, "G2")

# 6) 저장
wb.save("성적표_리포트.xlsx")
print("성적표_리포트.xlsx 저장 완료!")