중복 파일 삭제 스크립트를 돌렸다가 식은땀 흘린 날

이미지
중복 파일 삭제 스크립트를 돌렸다가 식은땀 흘린 날 이 블로그의 중복 파일 자동 삭제 편 과 파일명 일괄 변경 편 을 보면 공통적으로 "DRY_RUN"이라는 안전장치가 들어 있습니다. 실제 삭제나 변경 전에 미리보기부터 하도록 만든 이 습관은, 사실 처음부터 있던 게 아니라 한 번의 아찔한 경험 뒤에 생긴 것입니다. 당시 상황은 이랬습니다. 다운로드 폴더가 오래 방치되어 있어 용량을 확인해보니 중복 파일이 상당히 많았고, "파일 해시값을 비교해서 중복이면 자동으로 지우는" 스크립트를 처음 짜서 바로 실행했습니다. 사건 발생 — 실행 버튼을 누른 직후 처음 짠 코드는 대략 이런 형태였습니다. import hashlib from pathlib import Path from collections import defaultdict folder = Path(r"C:\Users\내이름\Downloads") hash_map = defaultdict(list) def get_hash(filepath): h = hashlib.md5() with open(filepath, "rb") as f: h.update(f.read()) return h.hexdigest() for file in folder.rglob("*"): if file.is_file(): hash_map[get_hash(file)].append(file) # 중복이면 첫 번째만 남기고 나머지 삭제 for files in hash_map.values(): if len(files) > 1: for f in files[1:]: f.unlink() # ← 바로 삭제 실행 print(f"삭제: {f.name}") 실행하자마자 터미널에 "삭제: ......

워드 문서 단어 일괄 교체 자동화! 파이썬으로 검색·치환하기

워드 문서 단어 일괄 교체 자동화! 파이썬으로 검색·치환하기 (완성 코드 공개)

파이썬으로 워드 파일에서 단어를 자동으로 검색하고 교체하는 모습


"거래처 이름이 변경됐는데 관련 계약서 30개를 전부 수정해야 한다", "연도가 바뀌어서 전체 보고서 템플릿의 '2025년'을 '2026년'으로 바꿔야 한다", "담당자 이름이 바뀌어서 수십 개 문서에서 일괄 교체가 필요하다"…

워드에서 Ctrl+H로 찾아 바꾸기를 한 파일씩 열어서 실행하는 방법은 파일 수가 많을수록 한계가 있습니다. 파이썬을 한 번만 세팅해두면 폴더 안의 모든 워드 파일에서 원하는 단어를 자동으로 찾아 교체하고 저장할 수 있습니다. 본문은 물론 표 안의 내용도 함께 처리합니다.

1단계: 준비물 설치

파이썬이 설치되어 있어야 합니다. 없다면 python.org에서 최신 버전을 받아 설치하세요. 설치 시 반드시 "Add Python to PATH"에 체크해야 합니다.

터미널(윈도우: CMD 또는 파워셸)을 열고 아래 명령어를 실행하세요:

pip install python-docx

python-docx는 워드(.docx) 파일을 읽고 수정하고 저장하는 라이브러리입니다. 본문 단락, 제목, 표, 머리글·바닥글까지 모두 접근할 수 있습니다.

💡 이 코드로 할 수 있는 것: 단일 워드 파일 또는 폴더 안의 모든 워드 파일에서 지정한 단어를 찾아 교체합니다. 여러 단어를 한꺼번에 교체할 수 있고, 본문·제목·표 안 텍스트를 모두 처리하며, 교체 결과를 원본에 덮어쓰거나 별도 파일로 저장할 수 있습니다.

2단계: 완성 코드

아래 코드를 그대로 복사해서 메모장에 붙여넣고, word_replace.py로 저장하세요. 저장 시 파일 형식은 "모든 파일", 인코딩은 UTF-8로 설정합니다.

from docx import Document
from pathlib import Path

# ① 설정
FOLDER_PATH  = r"C:\Users\내이름\Desktop\워드파일모음"  # ← 처리할 폴더 경로
OVERWRITE    = False   # ← True: 원본 덮어쓰기 / False: 별도 파일로 저장
OUTPUT_SUFFIX = "_수정본"   # ← OVERWRITE=False 일 때 저장 파일명 접미사

# ② 교체 규칙 (여러 개 동시 처리 가능)
REPLACE_MAP = {
    "A주식회사":  "B테크놀로지",   # 거래처명 변경
    "2025년":    "2026년",         # 연도 변경
    "홍길동":    "김철수",          # 담당자 변경
    # 필요한 만큼 추가 가능
}

# ③ 단락 내 텍스트 교체 함수 (서식 유지)
def replace_in_paragraph(para, replace_map):
    """단락의 서식을 유지하면서 텍스트를 교체합니다."""
    replaced = False
    for run in para.runs:
        for old, new in replace_map.items():
            if old in run.text:
                run.text = run.text.replace(old, new)
                replaced = True
    return replaced

# ④ 워드 파일 처리 함수
def process_docx(file_path, replace_map, overwrite, suffix):
    doc     = Document(str(file_path))
    count   = 0

    # 본문 단락 처리
    for para in doc.paragraphs:
        if replace_in_paragraph(para, replace_map):
            count += 1

    # 표 안의 셀 처리
    for table in doc.tables:
        for row in table.rows:
            for cell in row.cells:
                for para in cell.paragraphs:
                    if replace_in_paragraph(para, replace_map):
                        count += 1

    # 머리글·바닥글 처리
    for section in doc.sections:
        for para in section.header.paragraphs:
            if replace_in_paragraph(para, replace_map):
                count += 1
        for para in section.footer.paragraphs:
            if replace_in_paragraph(para, replace_map):
                count += 1

    # 저장
    if overwrite:
        save_path = file_path
    else:
        save_path = file_path.parent / (file_path.stem + suffix + file_path.suffix)

    doc.save(str(save_path))
    return count, save_path

# ⑤ 폴더 안의 모든 워드 파일 처리
folder    = Path(FOLDER_PATH)
docx_files = sorted(folder.glob("*.docx"))

print(f"  📂 처리할 파일: {len(docx_files)}개")
print(f"  🔄 교체 규칙: {len(REPLACE_MAP)}개\n")

if not docx_files:
    print("⚠ .docx 파일을 찾을 수 없습니다. FOLDER_PATH를 확인하세요.")
else:
    total_replaced = 0
    for file in docx_files:
        try:
            count, saved = process_docx(file, REPLACE_MAP, OVERWRITE, OUTPUT_SUFFIX)
            print(f"  ✔ {file.name}  →  {saved.name} ({count}곳 교체)")
            total_replaced += count
        except Exception as e:
            print(f"  ✘ {file.name} 처리 실패: {e}")

    print(f"\n✅ 완료! 총 {len(docx_files)}개 파일 / {total_replaced}곳 교체")

3단계: 실행 방법

  1. 코드 ① 설정의 FOLDER_PATH에 워드 파일이 있는 폴더 경로를 입력합니다.
  2. 코드 ② 교체 규칙의 REPLACE_MAP에 교체할 단어 쌍을 입력합니다. "찾을 단어": "바꿀 단어" 형태로 여러 개를 나열할 수 있습니다.
  3. OVERWRITE = False 상태로 먼저 실행해 결과를 확인합니다. 별도 파일(파일명_수정본.docx)이 생성됩니다. 원본에 덮어쓰려면 True로 변경합니다.
  4. 터미널에서 아래 명령어로 실행합니다:
python word_replace.py

정상 실행 시 터미널에 이렇게 출력됩니다:

  📂 처리할 파일: 5개
  🔄 교체 규칙: 3개

  ✔ 계약서_A주식회사.docx  →  계약서_A주식회사_수정본.docx (7곳 교체)
  ✔ 견적서_2025_1월.docx   →  견적서_2025_1월_수정본.docx  (3곳 교체)
  ✔ 보고서_홍길동.docx     →  보고서_홍길동_수정본.docx    (5곳 교체)
  ✔ 안내문_2025.docx       →  안내문_2025_수정본.docx       (2곳 교체)
  ✔ 업무일지_홍길동.docx   →  업무일지_홍길동_수정본.docx  (4곳 교체)

✅ 완료! 총 5개 파일 / 21곳 교체

4단계: 자주 발생하는 오류와 해결법

오류 1: 교체가 되었는데 워드에서 열면 일부가 안 바뀐 것처럼 보임

워드는 내부적으로 텍스트를 여러 run(서식 단위)으로 나눠 저장합니다. "홍길동"이 "홍", "길", "동"으로 분리 저장된 경우 코드가 인식하지 못합니다. 이 경우 워드에서 해당 텍스트를 한 번 지우고 다시 입력한 뒤 저장하면 run이 합쳐집니다. 또는 아래 응용 섹션의 run 병합 코드를 사용하세요.

오류 2: ModuleNotFoundError: No module named 'docx'

설치 시 docx가 아닌 반드시 python-docx로 입력해야 합니다.

python -m pip install python-docx

오류 3: PermissionError

처리하려는 파일이 현재 워드에서 열려 있을 때 발생합니다. 해당 파일을 닫은 후 다시 실행하세요.

응용: run이 분리되어 교체가 안 될 때 해결하기

워드 내부에서 텍스트가 여러 run으로 쪼개져 있을 때도 교체할 수 있는 방법입니다. 단락 전체 텍스트를 합쳐서 교체 후 첫 번째 run에 다시 저장하고 나머지 run을 비우는 방식입니다.

def replace_in_paragraph_safe(para, replace_map):
    """run이 분리된 경우에도 교체하는 안전한 방식"""
    full_text = "".join(run.text for run in para.runs)
    new_text  = full_text
    for old, new in replace_map.items():
        new_text = new_text.replace(old, new)

    if new_text != full_text and para.runs:
        para.runs[0].text = new_text
        for run in para.runs[1:]:
            run.text = ""
        return True
    return False

이 함수로 코드 ③의 replace_in_paragraph를 교체하면 run 분리 문제가 해결됩니다. 단, 서식(굵기, 색상 등)이 첫 번째 run의 서식으로 통일됩니다.

💡 이전 게시글과 결합하면: 워드 문서 자동 생성 편으로 템플릿에서 문서를 만든 뒤, 이 코드로 내용을 일괄 수정하는 2단계 워드 자동화 파이프라인을 구성할 수 있습니다. ZIP 자동 압축 편과 결합하면 수정된 파일 전체를 압축해서 한 번에 전달하는 것도 가능합니다.

핵심 요약

  • 준비물: Python + python-docx 설치 (pip install python-docx)
  • 설정: FOLDER_PATH(처리 폴더), REPLACE_MAP(교체 규칙), OVERWRITE(덮어쓰기 여부) 수정
  • 실행: 터미널에서 python word_replace.py 입력
  • 결과: 본문·표·머리글·바닥글 전체 교체, 교체 건수 출력, 원본 보존 또는 덮어쓰기 선택 가능

이 코드를 응용하면 특정 단어가 포함된 파일만 골라내거나, 교체 결과를 엑셀 로그로 남기는 것도 가능합니다.

이 블로그의 인기 게시물

느려진 구글 크롬 속도 2배 빨라지는 3가지 설정 방법 (2026년 최신 가이드)

이미지
  느려진 구글 크롬 속도 2배 빨라지는 3가지 설정 방법 (2026년 최신 가이드) 왜 구글 크롬은 점점 느려지는 걸까요? 전 세계에서 가장 많은 사람들이 사용하는 웹 브라우저인 구글 크롬(Google Chrome)은 직관적인 인터페이스와 뛰어난 호환성을 자랑합니다. 하지만 크롬을 오래 사용하다 보면 어느 순간부터 웹페이지 로딩 속도가 눈에 띄게 느려지거나, 탭을 여러 개 띄웠을 때 컴퓨터 전체가 버벅거리는 현상을 겪게 됩니다. 크롬이 느려지는 가장 큰 원인은 바로 '메모리(RAM) 점유율' 때문입니다. 크롬은 속도와 안정성을 높이기 위해 각 탭마다 별도의 프로세스를 실행하는 구조를 가지고 있는데, 이 때문에 탭을 많이 열어둘수록 컴퓨터의 메모리를 엄청나게 잡아먹는 일명 '램 먹는 하마'가 되어버립니다. 하지만 걱정하지 않으셔도 됩니다. 복잡한 외부 최적화 프로그램이나 백신을 설치할 필요 없이, 크롬 브라우저 내부의 기본 설정 몇 가지만 변경해 주어도 체감 속도를 2배 이상 끌어올릴 수 있습니다. 오늘은 초보자도 1분 만에 따라 할 수 있는 구글 크롬 속도 향상 및 최적화 방법 3가지를 상세히 알아보겠습니다. 크롬 속도 향상을 위한 핵심 설정 3단계 1: 크롬 '메모리 절약 모드' 활성화하기 가장 먼저 적용해야 할 것은 구글 크롬에서 공식적으로 지원하는 '메모리 절약 모드(Memory Saver)'를 켜는 것입니다. 이 기능은 현재 사용하지 않고 배경에 띄워져만 있는 비활성 탭의 메모리를 강제로 확보하여, 현재 내가 보고 있는 활성 탭에 컴퓨터의 자원을 몰아주는 아주 훌륭한 기능입니다. 크롬 브라우저를 실행한 후, 화면 우측 상단에 있는 **세 개의 점 아이콘(Chrome 맞춤설정 및 제어)**을 클릭합니다. 드롭다운 메뉴가 나타나면 하단의 [설정] 메뉴로 들어갑니다. 설정 화면 왼쪽 카테고리 메뉴에서 [성능] 탭을 클릭합니다. 상단에 보이는 '메모리 절약' 항목의 스위치를 클릭하여...
자세한 내용 보기

카카오톡 용량 줄이기! 대화방 파일 삭제로 스마트폰 용량 확보법 (1분 해결)

이미지
  카카오톡 용량 줄이기! 대화방 파일 삭제로 스마트폰 용량 확보법 (1분 해결) 내 스마트폰 용량을 좀먹는 주범, 카카오톡 스마트폰을 오래 사용하다 보면 어느 순간 '저장공간 부족' 알림이 뜨면서 사진을 찍거나 앱을 업데이트할 수 없는 답답한 상황을 맞게 됩니다. 불필요한 사진과 앱을 지워보지만, 용량은 좀처럼 늘어나지 않습니다. 이때 가장 먼저 의심해 봐야 할 주범이 바로 국민 메신저 '카카오톡'입니다. 카카오톡은 수많은 대화방에서 주고받는 수십, 수백 장의 사진과 동영상, 파일들을 스마트폰의 임시 저장소(캐시)에 쌓아둡니다. 이 데이터들이 수개월, 수년 동안 쌓이면 수 GB(기가바이트)에서 많게는 수십 GB까지 차지하게 되어 스마트폰 전체 속도를 늦추고 용량을 고갈시킵니다. 하지만 중요한 대화 내용을 유지하면서도 불필요한 찌꺼기 파일만 골라내어 스마트폰 용량을 획기적으로 확보하는 방법이 있습니다. 오늘은 초보자도 1분 만에 따라 할 수 있는 카카오톡 용량 줄이기의 핵심 방법 2가지를 상세히 알아보겠습니다. 전체 대화방 캐시 데이터 한 번에 삭제하기 (가장 확실한 효과) 카카오톡 설정 메뉴에는 각 대화방에 쌓여있는 임시 파일들을 한꺼번에 정리해 주는 아주 유용한 기능이 있습니다. 이 기능을 활용하면 텍스트 대화 내용은 그대로 유지하면서, 예전에 주고받았던 (지금은 볼 수 없는) 사진이나 동영상 데이터만 삭제하여 가장 큰 용량 확보 효과를 볼 수 있습니다. 카카오톡 앱을 실행한 후, 화면 우측 하단의 **[더보기(...) 아이콘]**을 클릭합니다. 우측 상단의 **[설정(톱니바퀴) 아이콘]**을 누릅니다. [데이터 및 저장공간 관리] 메뉴로 들어갑니다. (아이폰의 경우 [설정 > 기타 > 저장공간 관리] 순서) 화면 윗부분에 보이는 [임시 데이터 삭제] 삭제를 선택합니다.  (하단에 삭제 가능한 용량이 표시됩니다.) 팝업창이 뜨면 **[모두 삭제]**를 누릅니다. 이 기능은 텍스트 대화 내용을 지우지 않으므로 안심하...
자세한 내용 보기

업무 속도 3배 빨라지는 윈도우 기본 캡처 도구 단축키 및 200% 활용 꿀팁

이미지
  업무 속도 3배 빨라지는 윈도우 기본 캡처 도구 단축키 및 200% 활용 꿀팁 컴퓨터로 문서 작업을 하거나 인터넷 서핑을 하다 보면 화면의 특정 부분을 캡처해야 하는 순간이 매일 찾아옵니다. 과거에는 화면 전체를 복사하는 Print Screen(PrtScn) 키를 누르고 그림판에 붙여넣어 자르거나, 무거운 외부 캡처 프로그램을 따로 설치해서 사용하곤 했습니다. 하지만 윈도우 10과 윈도우 11에는 별도의 프로그램 설치가 전혀 필요 없는 아주 강력하고 편리한 '기본 캡처 도구'가 내장되어 있습니다. 단축키 하나만 외워두면 번거로운 과정 없이 원하는 화면을 1초 만에 잘라내고 공유할 수 있습니다. 오늘은 직장인과 학생들의 업무 및 과제 효율을 극대화해 줄 윈도우 캡처 도구의 핵심 단축키와 숨겨진 활용 꿀팁을 자세히 알아보겠습니다. 가장 완벽한 캡처 단축키: 윈도우키 + Shift + S 복잡한 프로그램을 켤 필요 없이, 지금 키보드에서 **[Windows 로고 키] + [Shift] + [S]**를 동시에 눌러보세요. 즉시 화면이 살짝 어두워지면서 모니터 상단에 4가지 캡처 모드를 선택할 수 있는 작은 메뉴 바가 나타납니다. 이 단축키가 윈도우 캡처의 핵심입니다. 상단 메뉴 바에서는 다음과 같은 4가지 모드를 제공합니다. 사각형 캡처: 마우스를 드래그하여 원하는 영역만 네모 반듯하게 잘라냅니다. 가장 많이 쓰이는 기능입니다. 자유형 캡처: 마우스가 움직이는 궤적을 따라 원하는 모양대로 자유롭게 오려낼 수 있습니다. 창 캡처: 현재 떠 있는 웹 브라우저나 폴더 등 특정 '창' 하나만 깔끔하게 선택하여 캡처합니다. 전체 화면 캡처: 듀얼 모니터를 포함한 모니터 화면 전체를 한 번에 찍습니다. 사각형 캡처를 선택하고 화면의 원하는 부분을 드래그하면, 캡처된 이미지가 자동으로 '클립보드(임시 저장소)'에 복사됩니다. 즉, 별도로 파일 저장을 하지 않아도 카카오톡 대화창이나 워드, 한글 프로그램에 대고 **Ctrl + ...
자세한 내용 보기