BlockCompare 문서
BlockCompare는 Compare DWG 모드로 시작합니다. 타이틀 바의 Compare DWG / Compare with Excel 스위치를 전환하면 두 번째 DWG 폴더 대신 내보낸 Excel 워크북과 비교하도록 바뀝니다. 어느 모드든 한 번에 한 화면씩 진행됩니다: Select Files → Review Matches → 짧은 Comparing… 진행 화면 → Comparison Report. 단계 표시기는 없으며, 각 Back 버튼은 정확히 이전 화면 인스턴스로 돌아갑니다(그 파일 목록, 필터, 편집 내용이 그대로 남아 있습니다). 보고서의 Finish는 Review Matches가 아니라 두 단계 전의 같은 Select Files(또는 Select Excel) 화면 인스턴스로 이동하며 — 그 파일 목록, 필터, 프로필도 Back으로 돌아갔을 때와 정확히 똑같이 남아 있습니다.
시작하기
스크린샷은 비교적 최근 릴리스를 기준으로 하며, 설치된 버전과 세부적인 화면이 다를 수 있습니다.
Comparing files
Compare DWG와 Compare with Excel
일반적인 두 폴더 방식의 작업 흐름과, 내보낸 Excel 워크북을 하나의 DWG 폴더와 비교하는 방식을 전환하는 타이틀 바 스위치입니다.
- Compare DWG(기본값)는 이 페이지 나머지에서 설명하는 두 폴더 방식의 작업 흐름입니다. Compare with Excel은 Select Files 화면의 Folder A 선택기를 단일 .xlsx 워크북 — 파트너 도구인 BlockSync가 생성하는 블록 데이터 내보내기 — 으로 대체하며, Folder B는 여전히 일반적인 DWG 폴더입니다.
- 모드를 전환해도 각 모드 자체의 Select Files 상태는 그대로 유지됩니다 — Compare with Excel로 전환했다가 다시 Compare DWG로 돌아가도 Folder A/B의 파일 목록이나 필터 선택은 사라지지 않습니다.
Compare with Excel — 워크북 선택
BlockSync가 내보낸 블록 데이터 워크북을 찾아 선택합니다. Folder B는 여전히 일반적인 DWG 폴더입니다.

- Browse…로 .xlsx 워크북을 선택합니다. 선택하면, 아무것도 스캔하기 전에 화면에 몇 개의 블록 인스턴스가 발견되었고 원래 몇 개의 소스 파일에 걸쳐 기록되어 있었는지 표시됩니다 — 예: "Found 13 block instance(s) across 2 source file(s) in this workbook."
- 워크북에 이미 있는 블록 이름이 자동으로 비교 범위가 됩니다 — 이 모드에는 별도의 Blocks/Layers/Viewports 체크리스트가 없습니다. 워크북 자체가 BlockSync에서 내보낼 때 선택되어 있던 내용을 이미 반영하고 있기 때문입니다.
- 이후는 Compare DWG와 동일한 Review Matches → Comparing → Comparison Report 흐름이며, 워크북에 기록된 파일 이름을 Folder B의 실제 파일과 짝짓습니다 — Hybrid가 아니라 Filename priority가 이 모드의 기본 매칭 전략입니다. 워크북 쪽에는 Hybrid 매칭에 가중치를 줄 실시간 핸들 데이터가 자체적으로 없기 때문입니다.
- Excel 워크북에는 해석된 레이어 색상이 없으므로, Layer name은 계속 비교되지만 LayerColor는 이 모드의 차이점 비교에서 제외됩니다 — 그렇지 않으면 모든 행이 가짜 색상 변경으로 표시될 것이기 때문입니다.
파일 추가(Folder A / Folder B)
비교할 도면 세트의 '이전'과 '이후' 리비전을 추가합니다.

- Add Files 또는 Add Folder로 Folder A(이전)와 Folder B(이후)를 독립적으로 구성합니다. Add Folder는 폴더 전체를 스캔해 .dwg 파일을 찾습니다 — 하위 폴더까지 스캔할지는 "Include subfolders when adding a folder"(Settings → AutoCAD, 기본값 꺼짐) 설정에 따라 달라지며, 양쪽 모두에 적용됩니다. 중복된 경로는 조용히 건너뛰어집니다.
- Folder A에서 파일을 추가, 제거, 또는 모두 지우면 아래 Blocks/Layers/Viewports 탭을 채우기 위한 가벼운 사전 스캔이 자동으로 실행됩니다 — 이 스캔이 실행되는 동안 Folder A 자체의 Add/Add Folder/Clear 버튼과 목록은 비활성화됩니다. Folder B는 매칭 후보를 제공하는 역할일 뿐 필터 탭을 구동하지 않으므로, 일부러 사전 스캔되지 않습니다.
- 각 목록에는 File Name과 색으로 구분된 Status가 표시되며, 행마다 Remove 버튼이 있습니다. 아직 아무것도 추가되지 않았을 때는 빈 표 대신 "No files yet — add a folder or files above."가 표시됩니다.
Blocks, Layers, Viewports로 필터링
Folder A의 내용을 기준으로 실제로 비교될 범위를 좁힙니다.

- Blocks 탭은 Folder A의 사전 스캔에서 발견된 모든 블록 정의를 나열합니다: Block Name, References, In Files, Dynamic, Has Attrs 플래그. Layers는 색상 견본과 In Files 개수와 함께 모든 레이어 이름을 나열합니다. Viewports는 모든 도면 공간 뷰포트를 Layout, Layer, Width, Height로 나열합니다.
- 각 탭에는 자체 Search 상자가 있습니다. All / None / Invert는 전체 목록이 아니라 현재 검색 결과로 표시된 항목에만 작동합니다.
- 탭에서 아무것도 체크하지 않으면 평소처럼 전체를 비교하며, 특정 블록/레이어를 체크하면 Scan & Match가 애초에 읽는 대상이 그것으로 제한됩니다. Viewports 선택은 스캔 후 별도의 바운딩 박스 필터로 적용되어, 체크된 뷰포트 중 하나 안에 실제로 들어오는 블록 인스턴스만 남깁니다.
- 다른 일부 CADXChange 비교 도구와 달리, 탭별로 별도의 저장 프로필이 있는 것이 아니라 세 탭 모두에 공유되는 하나의 Filter 프로필만 있습니다(다음 섹션 참고).
매칭 전략, 신뢰도, 저장된 프로필
BlockCompare가 어떤 '이전' 파일을 어떤 '이후' 파일과 짝짓는지 결정하는 방식입니다.

- Match strategy — Filename priority, Handle priority, 또는 Hybrid(기본값) — 는 제안된 짝짓기에서 파일 이름 유사도와 두 파일이 공유하는 블록 핸들 수 중 어느 쪽에 더 무게를 둘지 정합니다. Hybrid는 핸들 신호 쪽으로 기울어져 있으며, 이 덕분에 리비전이 파일 이름까지 바꾸더라도 매칭이 정확하게 유지됩니다.
- Confidence 슬라이더(0.00–1.00, 기본값 0.15)는 제안된 짝짓기의 종합 점수가 자동으로 채택되기 위해 넘어야 하는 기준선입니다. 이 기준선보다 낮은 점수의 짝짓기는 대신 미매칭 상태로 남아 다음 화면에서 수동으로 짝지을 수 있습니다. 슬라이더를 올리면 매칭이 더 엄격해지고, 내리면 약한 추측도 자동으로 채택됩니다.
- Filter profile Save…는 현재 Blocks/Layers/Viewports 선택을 이름을 붙여 저장하고, Load는 저장된 선택을 다시 적용해 이름이 일치하는 행을 체크하고 나머지는 체크 해제된 상태로 둡니다. Free 등급은 한 번에 하나의 저장된 프로필만 유지합니다 — 새로운 두 번째 이름으로 저장하려고 하면 기존 프로필을 조용히 대체하는 대신 업그레이드 안내가 표시됩니다(같은 이름으로 다시 저장하는 것은 항상 허용됩니다).
Scan & Match
양쪽 폴더를 읽고 파일 대 파일 짝짓기를 제안합니다 — 실제로 모든 DWG를 여는 단계입니다.
- Free 등급은 이를 한 쪽당(Folder A와 Folder B를 각각 계산) 파일 3개로 제한합니다 — 초과하면 부분 배치를 스캔하는 대신, 제한을 명시하는 메시지와 함께 아무것도 스캔되기 전에 전체 실행이 차단됩니다.
- Folder A를 먼저 스캔한 뒤 Folder B를 스캔하며, 슬롯당 백그라운드에서 한 번에 파일 하나씩 처리합니다. Free의 경우 Settings의 "Max Parallel AutoCAD Instances" 값과 상관없이 병렬 처리가 1로 고정되므로, Free 스캔은 항상 한 번에 한 파일씩 실행됩니다. 각 파일 고유의 MD5 해시도 이때 계산되며, 나중에 바이트 단위로 동일한 쌍을 감지하는 데 사용됩니다.
- 실패한 파일은 오류와 함께 표시되며 나머지 배치의 스캔을 막지 않습니다. 이 실패는 매칭 단계까지 이어져 짝지을 상대가 없는 파일로 처리됩니다.
- 매칭 자체는 단순한 최근접 매칭이 아니라 Folder A/Folder B 전체 쌍에 걸친 전역 최적 할당이므로, 한 파일에 가장 그럴듯해 보이는 짝이 다른 파일이 더 필요로 하는 상대를 가로챌 수 없습니다.
- 이 단계에는 Cancel 버튼이 없지만 파일마다 10분 제한이 있습니다. 손상되었거나 매우 큰 DWG에서 AutoCAD가 응답하지 않으면 중단되고 실패로 표시됩니다. 읽을 수 없는 파일은 비교에서 제외되어 다음 화면에 표시되며, '전부 추가/삭제'로 보고되지 않습니다.
Review Matches
무언가 비교되기 전에, 제안된 이전/이후 파일 짝짓기를 확인하거나 수정합니다.

- 각 행은 File A와 제안된 File B(모든 Folder B 파일을 나열하는 편집 가능한 드롭다운)를 나란히 보여주며, Filename %, Handle %, Combined % 점수도 함께 표시됩니다 — 이 백분율은 원래 제안된 짝짓기를 반영하며, 드롭다운에서 다른 File B를 수동으로 선택해도 다시 계산되지 않습니다.
- 빨간색으로 강조된 행은 충돌입니다 — 해당 파일에 대한 파일 이름 전용 최적 매칭과 핸들 전용 최적 매칭이 서로(또는 선택된 짝과) 일치하지 않는 경우이며, 결정하기 전에 차점 후보를 볼 수 있도록 Conflict candidate를 표시합니다.
- 확신 있는 매칭이 없는 Folder A 파일은 File B가 선택되지 않고 Exclude가 이미 체크된 자체 행으로 시작합니다 — File B를 직접 선택하고 Exclude를 해제하지 않으면 비교에서 제외됩니다.
- Change Strategy와 Re-match는 이미 스캔된 스냅샷만을 기준으로 매칭 알고리즘을 다시 실행합니다 — DWG를 다시 읽지 않으므로 사실상 즉시 실행되지만, 모든 행을 교체하며 마지막 스캔 이후 수동으로 변경한 File B나 Exclude 설정을 모두 버립니다.
- Compare는 제외되지 않고 File B가 선택된 행이 하나 이상 있어야 활성화됩니다.
비교 중(진행 화면)
매칭 확인과 보고서를 보는 사이의 짧은 진행 화면입니다 — 여기에도 Cancel 버튼은 없습니다.
- 확인된 쌍은 순서대로 한 번에 하나씩 비교되며, 진행 막대와 "Comparing {n}/{total}: {File A} vs {File B}" 상태가 각 쌍이 끝날 때마다 업데이트됩니다.
- 이 화면에는 Back도 Cancel도 없습니다 — 마지막 쌍이 끝나는 즉시 Comparison Report로 자동 이동합니다.
Comparison Report
매칭된 모든 쌍을 필드 단위로 보여줍니다 — 단순히 "다름"으로만 표시하지 않습니다.

- 결과는 매칭된 쌍별로 그룹화되며, 각각 "{File A} → {File B}"라는 제목의 펼침 섹션으로 표시됩니다. 해시가 바이트 단위로 동일한 쌍은 세부 목록 없이 "Identical file — comparison skipped."로 보고됩니다 — 이런 쌍에는 블록별 비교가 전혀 실행되지 않습니다.
- 차이점은 이름이나 위치가 아니라 AutoCAD 자체의 영구 객체 핸들로 매칭되므로, 이동했거나 이름이 바뀐 블록도 삭제 하나와 추가 하나로 보고되는 대신 같은 인스턴스로 인식됩니다.
- 각 항목은 Handle, Block Name, Kind(Added/Removed/Modified), 그리고 변경된 필드 수를 보여줍니다. 변경되지 않은 블록 인스턴스는 이 화면 목록에서 완전히 제외됩니다 — 각 그룹의 요약 줄에는 여전히 개수로 반영되지만, 행 단위로 나열되지는 않습니다. 그래야 수천 개의 변경되지 않은 인스턴스가 있는 도면에서도 실제로 바뀐 몇 건이 묻히지 않습니다.
- Details…(하나 이상의 필드가 변경되었을 때만 활성화됨)를 클릭하면 변경된 모든 필드의 이전/이후 값을 나란히 보여주는 작은 팝업이 열립니다. 팝업이 열려 있는 동안 다른 행의 Details를 클릭하면 먼저 닫을 필요 없이 대상만 바뀝니다.
- 페이지 수준 요약 줄은 각 그룹 자체의 요약에는 Unchanged 개수가 표시되더라도, 의도적으로 이를 생략합니다.
Exporting to Excel
Export to Excel
BlockCompare가 설치되지 않은 사람도 열 수 있는 워크북에 동일한 비교 결과를 기록합니다 — 화면상 보고서에서 제외된 내용까지 포함합니다.

- 비교된 모든 쌍에 걸쳐 고유한 블록 이름마다 시트 하나, 그리고 앱/AutoCAD 버전과 각 쌍의 파일 이름 및 MD5 해시를 나열하는 메타데이터 시트 하나입니다(어느 쌍이 동일했는지 독립적으로 확인할 수 있습니다).
- 화면상 보고서와 달리, 내보낸 시트에는 Added/Modified/Removed와 함께 Unchanged 행도 포함됩니다 — 화면에서만 빠질 뿐 파일에서는 아무것도 빠지지 않습니다.
- Added 행은 녹색으로 채워지고, Removed 행은 취소선과 함께 빨간색으로 채워집니다. Modified 행은 행 전체에 색이 채워지지 않는 대신, 변경된 각 셀에 이전 값을 기록하는 메모가 붙습니다 — 새 값은 그리드에 그대로 보이면서 이전 값은 마우스를 올리면 바로 확인할 수 있습니다. 이는 여기서 설명한 기본 "레코드당 한 행" 레이아웃입니다. 대안은 다음 섹션을 참고하세요.
- 내보낸 시트의 Status 열은 화면상 Kind 열과 다른 표현을 사용합니다 — Excel에서는 "Deleted"와 "Altered", 화면에서는 "Removed"와 "Modified"입니다. 두 가지를 서로 대조할 때 참고하세요.
- 내보내기 자체에는 행 수 제한이나 Free/Pro 제한이 없습니다 — Free도 얼마든지 큰 보고서를 내보낼 수 있으며, BlockCompare의 유일한 Free 등급 제한은 Scan & Match의 쪽당 파일 3개 제한입니다.
보고서 레이아웃 선택
Export to Excel을 클릭하면 먼저 두 가지 행 레이아웃 중 어느 것으로 보고서를 작성할지 묻는 작은 대화상자가 열립니다.

- One row per record(기본값)는 앞 섹션에서 설명한 레이아웃입니다: 변경된 필드의 이전 값이 셀 메모로 함께 실립니다.
- Adjacent before/after rows는 대신 모든 Modified 인스턴스를 두 행으로 확장합니다 — 어떤 모습인지는 다음 섹션을 참고하세요.
- 이 선택은 Modified 인스턴스가 어떻게 배치되는지에만 영향을 줍니다. Added, Removed, Unchanged 행은 어느 쪽을 선택하든 같은 방식으로 기록됩니다.
두 행짜리 이전/이후 레이아웃
대안 레이아웃: Modified 인스턴스의 이전 값과 이후 값이 한 행이 아니라 인접한 두 행에 놓이며, 변경된 필드가 양쪽 모두에서 강조 표시됩니다.

- Modified 인스턴스는 이전 값을 메모로 접어 넣는 단일 행 대신, 한 행이 아니라 두 행을 갖습니다 — 첫 번째 행에는 이전 값, 두 번째 행에는 이후 값이 담깁니다.
- Status 열은 첫 번째 행에서 "┌ ALTERED", 두 번째 행에서 "└ ALTERED"로 표시되어, 시트가 필터링되거나 정렬되어 흩어지더라도 두 행이 나란히 유지되는 데 의존하지 않고 하나로 연결된 단위로 읽힙니다.
- 두 행 사이에서 실제로 변경된 모든 필드는(메모로만 남기는 대신) 강조 표시되므로, 검토자가 강조된 셀을 하나씩 마우스로 확인하는 대신 두 행 전체를 나란히 훑어볼 수 있습니다.
- Added, Removed, Unchanged 인스턴스는 짝지을 "이전" 또는 "이후" 쪽이 없으므로 이 선택의 영향을 받지 않고 어느 쪽이든 한 행으로 유지됩니다.
설정
제목 표시줄의 톱니바퀴 아이콘에서 엽니다. 모든 항목은 즉시 저장되며 별도의 저장 버튼은 없습니다.
Language
Settings → GeneralEnglish / 简体中文 / 繁體中文 / 日本語 / 한국어 / Deutsch / Français / Italiano / Español. 언어를 변경하면 앱을 재시작해야 적용됩니다.
기본값: EnglishTheme
Settings → GeneralSystem / Light / Dark. 테마를 변경하면 앱을 재시작해야 적용됩니다.
기본값: Match systemAutoCAD version
Settings → AutoCAD가장 먼저 사용할 설치된 AutoCAD 버전입니다. 로드에 실패하면 앱이 자동으로 다른 설치된 버전으로 대체합니다.
기본값: Auto (newest installed)Max parallel AutoCAD instances
Settings → AutoCADAutoCAD가 백그라운드에서 한 번에 처리할 수 있는 도면 수입니다(선택 가능: 1, 2, 4, 6, 8, 12, 16). 값이 높을수록 빠르지만 CPU와 메모리를 더 많이 사용합니다 — 사양이 낮은 컴퓨터에서는 낮춰 사용하세요.
기본값: 8Include subfolders when adding a folder
Settings → AutoCADSelect Files 화면의 Add Folder에 Folder A와 Folder B 양쪽 모두 적용됩니다.
기본값: Off라이선스
라이선스 상태는 타이틀 바에 Free, Pro, Pro (offline), Expired 중 하나로 표시되며, Settings → License에서 전체 내용을 확인할 수 있습니다.
활성화하려면 Settings → License → "License key"에 라이선스 키를 붙여넣고 Activate를 클릭하세요. 라이선스를 다른 컴퓨터로 옮기려면 기존 컴퓨터에서 먼저 "Deactivate this machine"을 클릭한 다음, 새 컴퓨터에서 활성화하세요.
앱이 라이선스 서버에 연결할 수 없는 경우(인터넷 연결이 없거나 서버를 일시적으로 사용할 수 없는 경우), 이전에 활성화한 Pro 라이선스는 "Pro (offline)"으로 14일 동안 계속 작동합니다. 그 기간 안에 다시 연결해 재확인하세요. 14일 동안 확인에 성공하지 못했거나, 구독 종료일이 지났거나, 시스템 시계가 과거로 변경된 경우에는 재확인할 수 있을 때까지 라이선스가 Expired로 표시됩니다.
문제 해결
작업을 시작할 때 "AutoCAD not found" 또는 플러그인 신뢰 오류가 발생하는 경우
이 앱은 각 도면을 열고 처리하기 위해 백그라운드에서 AutoCAD를 구동하므로, 정식 라이선스가 있는 전체 버전의 AutoCAD 2021–2027 설치가 필요합니다 — AutoCAD LT는 지원하지 않습니다. AutoCAD가 설치되어 있는데도 이 오류가 계속 발생한다면, 해당 AutoCAD 버전이 이 컴퓨터에서 한 번도 실행된 적이 없을 가능성이 높습니다. 한 번 실행해(도면 화면까지만 띄워도 됩니다) 닫은 다음 다시 시도하세요 — AutoCAD는 대화형으로 최소 한 번 실행된 이후에만 해당 플러그인 위치를 신뢰합니다.
Review Matches에서 행이 빨간색으로 강조된 경우
파일 이름 전용 매칭과 핸들 전용 매칭이 이 "이전" 파일이 어느 "이후" 파일에 속하는지에 대해 서로 다른 결론을 내린 것입니다. Conflict candidate 열을 확인한 뒤, 제안된 매칭을 그대로 받아들이거나, File B 드롭다운에서 다른 후보를 선택하거나, 행을 Exclude하세요.
큰 폴더에서 스캔이 멈춘 것처럼 보이는 경우
Scan & Match 중에는 파일마다 10분 제한이 있습니다. 응답하지 않는 AutoCAD 백그라운드 프로세스(손상되었거나 매우 큰 DWG가 가장 흔한 원인)는 중지되고 해당 파일은 실패로 표시됩니다. 읽을 수 없는 파일은 매칭에서 제외되어 Review matches 화면에 표시됩니다. 마지막으로 읽던 파일은 로그 폴더에서 확인하세요.
추가한 파일이 Comparison Report에 나타나지 않는 경우
확신 있는 매칭이 없는 Folder A 파일은 Review Matches 화면에서 미리 제외된 상태(File B 미선택, Exclude 체크)로 시작합니다 — 뒤로 돌아가 File B를 선택하고 Exclude를 해제하지 않으면 Compare에서 조용히 제외됩니다.
내보낸 Excel 보고서가 화면상 보고서와 다른 표현을 사용하는 경우
이는 의도된 동작입니다 — 워크북의 Status 열은 화면상 Kind 열이 "Removed"/"Modified"라고 표기하는 부분을 "Deleted"/"Altered"로 표기합니다. 의미는 같고 두 화면 간 표현만 다릅니다.
Review Matches 화면의 Re-match가 새 파일을 반영하지 않는 것 같은 경우
Re-match는 이미 스캔된 블록/핸들 데이터를 기준으로 매칭 알고리즘만 다시 실행할 뿐, DWG를 다시 읽지 않습니다. 추가되거나 제거된 파일을 반영하려면 Select Files로 돌아가 Scan & Match를 다시 실행하세요.
로컬 파일
Settings → Diagnostics → Open Log Folder를 이용하면 로그 폴더로 바로 이동할 수 있어 문제 해결에 도움이 됩니다.
| Settings | %LocalAppData%\CADXChange\BlockCompare\settings.json |
| Logs | %LocalAppData%\CADXChange\BlockCompare\Logs\ |
| Filter 프로필 | %LocalAppData%\CADXChange\BlockCompare\Profiles\ |