이 글의 목적은 엑셀에서 “매크로를 사용하여 이 작업을 실행할 수 없습니다” 또는 “매크로를 실행할 수 없습니다(사용할 수 없음/사용 안 함)”와 유사한 오류가 발생할 때 근본 원인을 체계적으로 진단하고 재발 방지까지 포함한 실무형 해결 절차를 제공하는 것이다.
1. 오류 의미와 전형적 발생 상황 정리
오류 문구는 다양하나 공통적으로 VBA 코드 실행 경로가 차단되었거나 매크로의 참조·범위·보안·파일 형식·버전 호환성 문제로 인해 호출되지 못했음을 뜻한다. 다음 상황에서 빈발한다.
- 보안 설정에서 매크로가 차단되어 있거나 파일이 인터넷에서 내려받아 차단 표시(MOTW)가 남아 있을 때이다.
.xlsx같은 매크로 비지원 형식에 VBA가 들어 있거나,.xlsm인데 모듈이 손상되었을 때이다.- 버튼·도형에 할당된 매크로 이름/경로가 틀리거나 원본 통합 문서가 이동되어 경로가 끊어졌을 때이다.
- 필수 참조(References)가 누락되거나 32/64비트 Declare 호환이 맞지 않을 때이다.
- 시트/통합 문서 보호, 공유 모드, 편집 제한, 이벤트 비활성화 등 실행 조건이 막혔을 때이다.
- 조직 정책(GPO, M365 관리자 정책)으로 인터넷 매크로가 차단되었을 때이다.
주의 : 동일 문구라도 원인은 복합적인 경우가 많다. 아래 체크리스트를 순서대로 진행하여 단일 원인 단정으로 인한 오진을 피해야 한다.
2. 10단계 진단 체크리스트(빠른 실행용)
| No | 점검 항목 | 의심 신호 | 조치 |
|---|---|---|---|
| 1 | 파일 형식 확인 | .xlsx·.csv로 저장되어 있음 | .xlsm 또는 .xlsb로 다시 저장한다. 매크로 포함 형식에서만 VBA가 실행된다. |
| 2 | 보호된 보기/인터넷 차단 | 리본 상단에 “보호된 보기” 또는 “보안 경고” 배너 | 신뢰할 수 있으면 “편집 사용/콘텐츠 사용”을 누른다. 파일 속성에서 “차단 해제”로 MOTW 제거한다. |
| 3 | 신뢰할 수 있는 위치 | 열 때마다 보안 경고 반복 | 신뢰 센터 → 신뢰할 수 있는 위치에 폴더를 추가하고 파일을 그 안에서 관리한다. |
| 4 | 조직 정책 차단 | 콘텐츠 사용 버튼이 비활성, 인터넷 원본만 차단 | IT 정책에서 인터넷 매크로 차단 해제 또는 사내 전용 저장소로 이동하여 신뢰 서명을 적용한다. |
| 5 | 참조(References) 누락 | VBE에서 “MISSING” 참조 표기 | 도구 → 참조에서 누락 항목 체크 해제 후 대체 라이브러리 선택 또는 코드에서 Late Binding으로 전환한다. |
| 6 | 매크로 경로/이름 불일치 | 버튼 클릭 시 “Cannot run the macro '…'” | 도형 우클릭 → 매크로 지정에서 올바른 프로시저를 다시 지정한다. 외부 통합 문서 경로 참조라면 상대/절대 경로를 정리한다. |
| 7 | 이벤트 비활성화 | 워크시트/통합 문서 이벤트가 전혀 작동 안 함 | Application.EnableEvents = True로 복구하고 예외 처리 루틴을 추가한다. |
| 8 | 보호·공유·공동편집 제한 | 보호 통합 문서/시트, 공유 통합 문서 모드 | 보호 해제 후 실행한다. 공동편집 모드에서 제한되는 기능을 피한다. |
| 9 | 32/64비트 Declare 호환 | API 호출 매크로에서만 실패 | PtrSafe·LongPtr로 선언을 업데이트한다. |
| 10 | 모듈/프로젝트 손상 | 특정 모듈만 실행 시 즉시 오류 | 새 통합 문서에 모듈을 내보내기/가져오기 한다. VBE에서 디버그 → 컴파일로 검증한다. |
3. 보안·정책 원인 해결(신뢰 센터, MOTW, 서명)
3.1 신뢰 센터 기본값 점검
- 파일 → 옵션 → 신뢰 센터 → 신뢰 센터 설정을 연다.
- “매크로 설정”에서 “알림 표시 후 매크로 사용 안 함” 또는 “디지털 서명된 매크로만 사용”을 선택한다.
- “신뢰할 수 있는 위치”에 프로젝트 폴더를 추가한다.
주의 : 조직 환경에서는 로컬 설정이 GPO로 덮어써질 수 있다. 이 경우 IT 관리자 정책을 확인해야 한다.
3.2 인터넷에서 받은 파일 차단 해제
인터넷에서 내려받은 파일에는 MOTW가 붙는다. 아래 방법으로 제거한다.
- 파일 우클릭 → 속성 → “차단 해제” 체크 후 확인한다.
- 여러 개라면 PowerShell에서 일괄 처리한다.
Unblock-File -Path "D:\Work\VBA\*.xlsm" 3.3 코드 서명(기업 환경 권장)
자체 서명 또는 기관 발급 인증서로 VBA 프로젝트에 서명한다. 사용자는 신뢰할 수 있는 게시자로 등록하면 추가 경고 없이 실행된다.
4. 파일 형식·경로·할당 오류 정정
4.1 올바른 확장자 사용
- 매크로 포함:
.xlsm또는.xlsb를 사용한다. - 매크로 미포함:
.xlsx·.csv는 코드 저장·실행이 불가하다.
4.2 도형/버튼에 지정된 매크로 경로 재지정
도형·양식 컨트롤이 외부 통합 문서의 매크로를 가리키면 파일 이동 시 경로가 깨진다. 다음을 수행한다.
- 도형 우클릭 → 매크로 지정에서 현재 대상명을 확인한다.
- 대상명이
Book1.xlsm!Module1.RunMe처럼 파일명을 포함하면 현재 파일의 로컬 프로시저로 바꾼다. - 여러 개를 일괄 정리하려면 아래 유틸 매크로를 사용한다.
Sub Fix_AssignedMacros_ToLocal() Dim shp As Shape, n$, tgt$ For Each shp In ActiveSheet.Shapes On Error Resume Next n = shp.OnAction If InStr(1, n, "!") > 0 Then tgt = Split(n, "!")(UBound(Split(n, "!"))) shp.OnAction = tgt End If On Error GoTo 0 Next End Sub 주의 : ActiveX 컨트롤은
OnAction가 아니라 이벤트 프로시저로 연결된다. 이 경우 VBE 코드 비하인드를 확인해야 한다.5. 참조(References)·호환성 오류 해결
5.1 누락 참조 진단
- VBE(Alt+F11) → 도구 → 참조를 연다.
- MISSING 표시가 있으면 체크를 해제하거나 올바른 버전을 선택한다.
- 가능하면 Early Binding 대신 Late Binding으로 전환하여 버전 종속을 낮춘다.
'Early Binding 예(버전 종속) Dim wd As Word.Application
'Late Binding 대안(권장)
Dim wd As Object
Set wd = CreateObject("Word.Application")
5.2 64비트 Office 호환 선언
WinAPI를 호출하는 Declare는 64비트에서 PtrSafe와 LongPtr를 사용한다.
#If VBA7 Then Private Declare PtrSafe Function GetTickCount Lib "kernel32" () As Long #Else Private Declare Function GetTickCount Lib "kernel32" () As Long #End If 6. 이벤트·보호·공동편집 관련 차단 해제
6.1 이벤트가 꺼진 경우 복구
오류 처리 없이 종료되면 Application.EnableEvents가 False로 남을 수 있다. 복구 후 템플릿화한다.
Sub SafeRun() On Error GoTo EH Application.EnableEvents = True Application.ScreenUpdating = False '... 핵심 작업 ... CleanExit: Application.ScreenUpdating = True Application.EnableEvents = True Exit Sub EH: MsgBox "오류: " & Err.Number & " - " & Err.Description Resume CleanExit End Sub 6.2 보호·공유 모드 확인
- 검토 탭 → 시트 보호/통합 문서 보호가 켜져 있으면 해제한다.
- 공유 통합 문서 또는 공동편집 파일에서는 특정 VBA 작업이 제한된다. 단독 편집으로 테스트한다.
7. 진단 스크립트(원인 분류 자동화)
실행 환경·참조·이벤트·파일 상태를 한 번에 점검한다.
Sub DiagnoseVBAEnvironment() Dim msg As String, ref As Reference msg = "진단 결과" & vbCrLf msg = msg & "- 버전: " & Application.Version & IIf(Application.Is64Bit, " (64-bit)", " (32-bit)") & vbCrLf msg = msg & "- 이벤트: " & IIf(Application.EnableEvents, "활성", "비활성") & vbCrLf msg = msg & "- 계산: " & IIf(Application.Calculation = xlCalculationManual, "수동", "자동") & vbCrLf msg = msg & "- 경로: " & ThisWorkbook.FullName & vbCrLf msg = msg & "- 매크로 형식: " & IIf(ThisWorkbook.Name Like "*.xlsm" Or ThisWorkbook.Name Like "*.xlsb", "예", "아니오") & vbCrLf On Error Resume Next For Each ref In ThisWorkbook.VBProject.References If ref.IsBroken Then msg = msg & " * 누락 참조: " & ref.Name & vbCrLf Next On Error GoTo 0 MsgBox msg, vbInformation End Sub 주의 : 일부 환경에서는
VBProject 접근이 신뢰 센터의 “VBA 프로젝트 개체 모델에 대한 신뢰 액세스” 옵션에 의해 제한된다. 필요 시 체크를 활성화한다.8. 버튼이 눌려도 “아무 일도 안 일어남”일 때
오류 메시지가 없고 동작이 없을 때는 다음을 점검한다.
- 프로시저 범위:
Private Sub는 할당 실행이 불가하다.Public Sub로 노출한다. - 이름 충돌: 시트/통합 문서 수준 이름과 모듈 이름이 중복되면 호출이 엉킬 수 있다. 모듈명을 고유하게 바꾼다.
- 조건부 컴파일:
#If분기에서 현재 환경 경로가 비활성일 수 있다. - Application.Calculation=Manual 상태에서 화면 갱신이 없어 변화가 숨을 수 있다.
9. 손상 의심 시 복구 절차
- VBE에서
디버그 → 컴파일 VBAProject수행으로 구문·참조 오류를 먼저 제거한다. - 모듈을
.bas로 내보내기 후 새 통합 문서(.xlsm)에 가져오기 한다. - 양식(폼)·클래스도 동일 방식으로 단계적 이식 후 테스트한다.
- P-Code 캐시 이슈가 의심되면 Office 복구를 고려한다.
10. 재발 방지: 배포·운영 표준
- 배포 전 코드 서명과 신뢰 위치 이용으로 사용자 개입을 최소화한다.
- 외부 경로 의존(다른 통합 문서 호출, 네트워크 드라이브)을 상대 경로 또는 구성값으로 추상화한다.
- Late Binding을 우선 사용하고, 필요한 경우 버전 체크 로직을 코드에 포함한다.
- 모든 진입점에 표준 오류 처리와
EnableEvents복구 루틴을 포함한다. - 릴리스 체크리스트: 확장자, 서명, 참조, 64비트 테스트, 버튼 연결 재지정, 보호 상태 확인이다.
11. 사례별 해법 요약(원인→행동)
| 원인 | 즉시 조치 |
|---|---|
| 인터넷 차단(MOTW) | 속성에서 차단 해제 또는 Unblock-File 실행 후 신뢰 위치에서 열기 |
| 매크로 비지원 확장자 | .xlsm/.xlsb로 저장 후 모듈 재가져오기 |
| 버튼의 잘못된 OnAction | 매크로 지정 다시 연결 또는 스크립트로 일괄 수정 |
| 참조 누락 | Late Binding 전환 또는 올바른 라이브러리 선택 |
| 이벤트 비활성 | Application.EnableEvents=True로 복구, 예외 처리 추가 |
| Declare 64비트 미준수 | PtrSafe/LongPtr로 업데이트 |
| 보호/공유 제한 | 보호 해제, 단독 편집에서 테스트 |
| 프로젝트 손상 | 모듈 내보내기→새 파일에 이식 후 컴파일 |
12. 표준 템플릿: 오류 안전 실행 래퍼
Option Explicit
Public Sub Run_Main()
SafeExecute AddressOf Task_Main
End Sub
Private Sub Task_Main()
'핵심 로직
Debug.Print "작업 실행"
End Sub
Public Sub SafeExecute(ByVal worker As LongPtr)
On Error GoTo EH
Application.ScreenUpdating = False
Application.EnableEvents = True
Application.Calculation = xlCalculationAutomatic
'델리게이트 호출
CallByName Me, "Task_Main", VbMethod
Clean:
Application.ScreenUpdating = True
Application.EnableEvents = True
Exit Sub
EH:
MsgBox "오류 " & Err.Number & ": " & Err.Description, vbExclamation
Resume Clean
End Sub
주의 :
CallByName 사용이 부담되면 직접 Task_Main을 호출한다. 핵심은 공통의 진입점에서 환경을 복구하는 패턴화이다.FAQ
“Cannot run the macro 'xxx'. The macro may not be available…”와 본 오류는 무엇이 다른가?
전자는 주로 매크로 경로·이름·범위 오류 또는 참조 누락을 지칭한다. 본 글의 문구는 보안·정책·환경 제약까지 포함해 보다 넓은 차단 상태를 포괄한다. 체크리스트 2·3·4·6단계를 우선 수행한다.
파일을 열 때마다 보안 경고가 뜬다. 안전하게 없앨 수 있나?
신뢰할 수 있는 위치에 폴더를 추가하고 그 위치에서만 파일을 연다. 기업 환경은 코드 서명과 게시자 신뢰 등록을 병행한다.
버튼을 눌러도 메시지 없이 무반응이다. 어디부터 봐야 하나?
프로시저 접근 제한(Private) 여부, 모듈/시트 이름 충돌, EnableEvents 상태, OnAction 경로를 차례로 확인한다. 진단 매크로로 환경부터 점검한다.
다른 PC에서는 되는데 내 PC만 안 된다.
로컬 보안 정책·참조 버전·Office 비트수 차이 가능성이 크다. 진단 결과에서 버전과 참조를 비교해 일치시킨다.
공동편집(OneDrive/SharePoint)에서 매크로가 자주 막힌다.
공동편집은 매크로와의 상호작용이 제한될 수 있다. 단독 편집으로 전환하거나 매크로 없이도 동작하는 구조로 설계를 변경한다.