IronPDF for Node.js에서의 verbatimModuleSyntax 오류

Curtis Chau

Updated: 2026년 6월 29일

Download IronPDF

• Node Download

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # IronPDF for Node.js에서의 verbatimModuleSyntax 오류 TypeScript 프로젝트에서 IronPDF for Node.js를 사용할 때, `verbatimModuleSyntax` 컴파일러 옵션은 `import` 및 `export` 문이 어떻게 출력되는지를 제어하며, 모듈 시스템과 충돌할 경우 빌드 오류를 발생시킬 수 있습니다. ## 옵션의 동작 방식 **`false`로 설정 (일반 선택):** TypeScript는 대상 모듈 시스템에 맞게 import 및 export 문을 재작성합니다. CommonJS 대상을 사용할 때 ESM 스타일의 가져오기를 (`import ... from '...'`) into `require()` 호출; ESNext 대상을 사용할 때 ESM 구문을 유지합니다. **`true`로 설정:** TypeScript는 작성된 그대로 import 및 export 구문을 유지합니다. ESM 구문은 대상에 관계없이 ESM으로 남게 되며, 모듈 시스템이 이를 지원하지 않을 때 실패합니다. ## 활성화 시의 오류 `"verbatimModuleSyntax": true`로 CommonJS 빌드는 다음과 같은 오류로 실패할 수 있습니다: ```txt A top-level 'export' modifier cannot be used on value declarations in a CommonJS module when 'verbatimModuleSyntax' is enabled. ``` ```txt ESM syntax is not allowed in a CommonJS module when 'verbatimModuleSyntax' is enabled. ``` 첫 번째는 CommonJS가 최상위 `export`를 지원하지 않기 때문에 발생합니다; 두 번째는 CommonJS 모듈에 대해 ESM 구문이 변환되지 않고 남은 경우입니다. ## 추천 대부분의 프로젝트에서는 옵션을 비활성화하여 TypeScript가 모듈 구문을 조정하도록 유지하세요: ```json { "compilerOptions": { "verbatimModuleSyntax": false } } ``` 특정 번들러나 환경에 대한 엄격한 구문 보존이 필요하다면, 사용 중인 모듈 시스템이 소스에서 사용하는 구문을 완전히 지원하는 경우에만 `true`로 설정하십시오.

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

TypeScript 프로젝트에서 IronPDF for Node.js를 사용할 때, verbatimModuleSyntax 컴파일러 옵션은 import 및 export 문이 어떻게 출력되는지를 제어하며, 모듈 시스템과 충돌할 경우 빌드 오류를 발생시킬 수 있습니다.

옵션의 동작 방식

false로 설정 (일반 선택): TypeScript는 대상 모듈 시스템에 맞게 import 및 export 문을 재작성합니다. CommonJS 대상을 사용할 때 ESM 스타일의 가져오기를 (import ... from '...') into require() 호출; ESNext 대상을 사용할 때 ESM 구문을 유지합니다.

true로 설정: TypeScript는 작성된 그대로 import 및 export 구문을 유지합니다. ESM 구문은 대상에 관계없이 ESM으로 남게 되며, 모듈 시스템이 이를 지원하지 않을 때 실패합니다.

활성화 시의 오류

"verbatimModuleSyntax": true로 CommonJS 빌드는 다음과 같은 오류로 실패할 수 있습니다:

A top-level 'export' modifier cannot be used on value declarations in a CommonJS module when 'verbatimModuleSyntax' is enabled.

A top-level 'export' modifier cannot be used on value declarations in a CommonJS module when 'verbatimModuleSyntax' is enabled.

ESM syntax is not allowed in a CommonJS module when 'verbatimModuleSyntax' is enabled.

ESM syntax is not allowed in a CommonJS module when 'verbatimModuleSyntax' is enabled.

첫 번째는 CommonJS가 최상위 export를 지원하지 않기 때문에 발생합니다; 두 번째는 CommonJS 모듈에 대해 ESM 구문이 변환되지 않고 남은 경우입니다.

추천

대부분의 프로젝트에서는 옵션을 비활성화하여 TypeScript가 모듈 구문을 조정하도록 유지하세요:

{
  "compilerOptions": {
    "verbatimModuleSyntax": false
  }
}

{
  "compilerOptions": {
    "verbatimModuleSyntax": false
  }
}

특정 번들러나 환경에 대한 엄격한 구문 보존이 필요하다면, 사용 중인 모듈 시스템이 소스에서 사용하는 구문을 완전히 지원하는 경우에만 true로 설정하십시오.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...

더 읽어보기