고객이 직접 제공한 엑셀을 다시 저장하지 마세요. 외부 링크를 먼저 확인하세요

고객이 보낸 엑셀은 로컬에서 정상적으로 열리지만 Python 스크립트로 처리하거나 시스템에 업로드한 후 수식이 #REF!로 변경되거나 드롭다운 메뉴가 사라지거나 열리지 않는 경우가 있습니다. 이는 일반적으로 파일 손상이 아니라 다시 저장할 때 외부 링크 캐시나 VBA 매크로를 그대로 유지하지 않는 자동화된 도구입니다.

이 문서는 스크립트를 사용하여 Excel을 일괄 처리해야 하는 개발자와 운영자를 위해 작성되었습니다. 다음은 openpyxl의 기본 로딩으로 인해 어떤 정보가 손실되는지 설명하고, 합성 샘플 검사 아이디어를 제공하고, 승인 중에 수동 검토가 필요한 경계를 나열합니다. 이 내용을 읽고 나면 문서를 저장하기 전에 확인해야 할 사항을 결정할 수 있습니다.

한 문장으로 결론: Excel을 다시 저장하기 전에 외부 링크 및 VBA 구성 요소 목록을 작성하세요.

먼저 파일 패키지에 VBA 프로젝트와 외부 링크 구성 요소가 있는지 확인한 다음 로드 매개 변수를 결정하고 승인 중에 수동 검토 프로세스를 유지합니다.

당신의 상황	권장 사례	이유
파일 패키지는 vbaProject.bin에 있습니다.	별도로 검토해야 하는 내용이 포함되어 있으며 매크로가 실행되지 않는다는 메시지가 표시됩니다.	구성 요소가 있다고 해서 매크로가 유효하거나 콘텐츠가 안전하다는 의미는 아닙니다.
파일 패키지에 외부 링크 구성 요소가 있습니다.	패키지 내의 위치를 기록하고 대상에 액세스하지 않습니다.	스크립트는 인벤토리만 수행하며 대상에 액세스할 수 있는지 여부는 확인하지 않습니다.
keep_vba=True로 로드	로딩 전략이라고 생각하세요	keep_vba=True는 보존 정책이지 매크로 감지의 증거가 아닙니다.

##기본 로딩 시 주요 정보가 손실되는 이유

공식 openpyxl 문서에는 load_workbook가 셀이 아닌 데이터를 처리하기 위한 명확한 경계가 있다고 명시되어 있습니다. keep_links의 기본값은 True로, 이는 XML의 링크 정의를 유지하지만 다시 로드한 후에도 외부 데이터 캐시(캐시된 값)가 여전히 유효하다는 것을 보장하지 않습니다. 원래 네트워크 환경이나 원본 파일 경로를 벗어나면 새로 고칠 때 Excel에서 계속 오류를 보고할 수 있습니다.

keep_vba의 기본값은 False입니다. 원본 파일에 매크로가 포함된 경우 기본적으로 로드 및 저장 후 VBA 프로젝트가 제거됩니다. 차트, 도형 등의 개체도 읽을 때 무시될 수 있습니다.

이는 버그가 아니라 라이브러리 자체의 기능적 경계입니다. 프로덕션 수준 파일로 작업할 때는 도구가 모든 기능을 자동으로 유지한다고 가정하기보다는 보존 정책을 명시적으로 선언해야 합니다.

합성 예제 및 테스트 파일 준비

이 메커니즘을 안전하게 시연하려면 실제 고객 데이터에 의존하지 않는 합성 시나리오를 구성하는 것이 좋습니다.

테스트 파일 준비

새로운 Excel 통합 문서를 만듭니다.
VBA 편집기(Alt+F11)에 빈 모듈을 삽입합니다.
셀 A1에 수식 ='[ExternalBook.xlsx]Sheet1'!$A$1를 입력합니다. 실제 외부 파일을 만들 필요는 없으며 이 참조 구조를 유지하기만 하면 됩니다.
매크로 사용 형식 input_check.xlsm로 저장합니다.

일반적인 실수와 경계 입력

기본 load_workbook('input_check.xlsm')를 사용하여 매크로 지원 파일을 로드한 다음 .xlsx로 저장하면 VBA 코드가 자동으로 삭제됩니다.
로딩 시 keep_vba=True를 지정하지 않았으나 강제로 .xlsm로 저장한 경우, 파일 헤더가 실제 내용과 일치하지 않아 엑셀 열기가 거부될 수 있습니다.
읽기 전용 모드(read_only=True)에서는 keep_links 및 keep_vba 매개변수가 유효하지 않으며 특성을 보존하려는 모든 시도가 실패합니다.

외부 링크 및 매크로용으로 예약된 인증 코드

다음 예에서는 매개변수의 역할을 보여주기 위해 메모리에서 논리 검사를 구성합니다.

from io import BytesIO
from zipfile import ZipFile
from openpyxl import Workbook
def inventory(raw):
    with ZipFile(BytesIO(raw)) as z:
        names = set(z.namelist())
    return {"has_vba_part": "xl/vbaProject.bin" in names,
            "external_link_parts": sorted(n for n in names if n.startswith("xl/externalLinks/externalLink") and n.endswith(".xml"))}
out = BytesIO()
Workbook().save(out)
assert inventory(out.getvalue()) == {"has_vba_part": False, "external_link_parts": []}
synthetic = BytesIO()
with ZipFile(synthetic, "w") as z:
    z.writestr("xl/vbaProject.bin", b"not executable VBA; fixture only")
    z.writestr("xl/externalLinks/externalLink1.xml", b"<fixture/>")
result = inventory(synthetic.getvalue())
assert result["has_vba_part"]
assert result["external_link_parts"] == ["xl/externalLinks/externalLink1.xml"]

이 코드는 완전한 파일 복구 도구가 아닌 교육 예제일 뿐이며 실제 프로덕션 환경에서 실행되지 않았습니다. 실행하기 전에 위와 같이 input_check.xlsm가 준비되어 있는지 확인하시기 바랍니다.

📊 핵심 비교: 기본 매개변수와 예약 매개변수

매개변수	기본값	효과	경계
keep_links	진실	XML의 링크 정의 유지	다시 로드한 후 외부 데이터 캐시의 유효성이 보장되지 않습니다.
keep_vba	거짓	VBA 프로젝트는 기본적으로 유지되지 않습니다.	True로 설정한다고 해서 매크로 내용이 안전하거나 유효하다는 의미는 아닙니다.
읽기 전용	False	읽기 전용 모드로 로드	이 모드에서는 keep_links와 keep_vba가 효과가 없습니다

수제 기준과 수동 검토 경계

Excel의 모든 예외 상황을 자동화할 수는 없습니다. 아래 표는 스크립트로 검토할 상황과 가로채기 또는 수동 처리가 필요한 상황을 구분하는 데 사용됩니다.

관찰	무엇을 해야 할까요	그리고 판단해서는 안 된다
VBA 구성 요소가 있습니다	참고: 별도의 검토가 필요한 내용을 포함하고 있습니다	매크로 실행 없음
외부 링크 구성 요소	패키지 내부 위치를 기록하세요	목표물에 접근할 수 없다
매개변수를 활성화 상태로 유지하세요	이것을 로딩 전략으로 생각하세요	이것이 매크로 측정 증거로 간주되어서는 안 됩니다

스크립트는 매개변수가 효과적인지 검증할 수 있지만, 출력 파일이 비즈니스 수준에서 제공된다는 보장은 없습니다. 예를 들어, keep_links=True는 링크 정의를 성공적으로 보존했습니다. 대상 서버가 오프라인이라도 Excel에서 새로고침할 때 오류가 발생할 수 있습니다. 이러한 문제들은 문서 처리 도서관의 책임을 넘어 수작업 검토 절차가 필요합니다.

참고문헌

문서 번역을 위해 이 체크리스트를 사용하세요

공식과 비즈니스 코드가 포함된 테이블을 처리할 때는 먼저 어떤 내용이 텍스트이고 어떤 내용이 공식, 식별자, 비즈니스 코드인지 구분한 후 번역합니다. 번역 후 검사는 중국어가 목표 언어로 변환되었는지 여부뿐만 아니라 공식, 식별자, 인용 관계가 변경되지 않았음을 확인합니다.

OmniDoc (제품 입력)는 다중 형식의 문서 번역 포털을 제공하며, 공식 웹사이트에서는 OCR, 용어집, 이중언어 참고 기능을 소개합니다. 파일을 직접 시작하고자 하는 팀의 경우, 실제 샘플을 사용해 이 경로를 평가할 수 있습니다. 업로드를 승인한 익명 파일을 사용해 이 기사의 체크리스트와 결과를 확인해 주시기 바랍니다. 이는 OmniDoc이 이 기사에서 언급한 오픈소스 라이브러리나 내부 알고리즘을 사용한다는 주장도 아니며, 제품 성능 테스트를 예시로 대체하지도 않습니다.

🎯 어떤 방법이 당신에게 맞나요?

매크로가 포함된 파일을 일괄 처리해야 한다면

먼저 keep_vba=True를 사용해 보존 전략을 명확히 하고, 테스트 환경에서 출력 결과를 비교하세요. 매크로가 자동으로 유지된다고 가정하지 마세요.

엑셀에 외부 링크가 포함되어 있다면

먼저, 패키지 내 링크 컴포넌트 위치를 기록하세요; 스크립트에서 링크 타겟에 접근하지 마세요. 저장 후에는 새로고침이 정상인지 수동으로 확인하세요.

데이터만 읽으면 된다면

읽기 전용 모드를 고려할 수 있지만, 이 모드에서는 keep_links와 keep_vba 매개변수가 유효하지 않습니다.

파일이 클라이언트에서 온 민감한 내용이 포함되어 있다면

먼저, 원본을 보관하고, 탈감작된 샘플을 검사용으로 사용한 후, 승인 항목에 따라 결과를 검토하세요.

❓ 자주 묻는 질문 (FAQ)

1. keep_links=참(True)은 외부 링크가 항상 이용 가능하다는 의미인가요?

아니. keep_links는 XML의 링크 정의를 유지하지만, 재저장 후에도 외부 데이터 캐시가 유효하게 유지된다는 보장은 없습니다. 대상이 접근할 수 없을 때는 여전히 오류를 일으킬 수 있습니다.

2. 기본적으로 로드 및 저장 시 매크로는 어떻게 되나요?

keep_vba는 기본적으로 False이며, 원본 파일의 VBA 프로젝트는 저장 시 제거됩니다. 만약 계속 유지해야 한다면, keep_vba=True를 명시적으로 설정해야 합니다.

3. VBA 컴포넌트가 감지되면 스크립트가 매크로가 안전한지 판단할 수 있나요?

아니. 컴포넌트의 존재가 콘텐츠가 안전하거나 매크로가 유효하다는 의미는 아닙니다; 스크립트는 매크로를 실행해서는 안 되며 추가 검토를 유도해야 합니다.

4. 링크와 매크로를 읽기 전용 모드에서 보존할 수 있나요?

아니. read_only=True 모드에서는 keep_links와 keep_vba 매개변수가 유효하지 않습니다.

📝 요약

엑셀을 복원하기 전에 먼저 VBA와 외부 연결 구성 요소를 재고하고, 매개변수를 명확히 로드하며, 수동 검토 단계를 유지하세요. 다음으로, 테스트 환경에서 세 개의 샘플 파일(순수 데이터 .xlsx, 매크로 .xlsm, 외부 링크가 있는 .xlsx)을 준비하고, 각각 기본값과 예약된 매개변수로 불러와 저장하며, 실제 결과를 위 표에 기록할 수 있습니다. 각 매개변수가 파일 세트에 미치는 결과를 이해했을 때에만 스크립트를 프로덕션 프로세스에 배포하는 것이 적절합니다.

지금 경험해보세요: 원본 형식을 유지하면서 번역을 시작하려면 문서를 업로드하세요