다음은 tsc --init을 통해 생성되는 tsconfig.json 파일의 compilerOptions에 해당하는 내용을 기계 번역하고 어색하거나 이해하기 어려운 부분은 의역한 글이며 잘못된 해석이 포함될 수 있습니다. 오타, 오역 지적은 모두 환영합니다.
프로젝트
"incremental": true
프로젝트를 증분 컴파일할 수 있도록 .tsbuildinfo 파일을 저장합니다.
"composite": true
TypeScript 프로젝트를 프로젝트 참조와 함께 사용할 수 있는 제약 조건을 사용합니다.
"tsBuildInfoFile": "./.tsbuildinfo"
.tsbuildinfo 증분 컴파일 파일의 경로를 지정합니다.
"disableSourceOfProjectReferenceRedirect": true
복합 프로젝트를 참조할 때 선언 파일 대신 소스 파일을 선호하지 않도록 설정합니다.
"disableSolutionSearching": true
편집할 때 다중 프로젝트 참조 확인에서 프로젝트를 선택 해제합니다.
"disableReferencedProjectLoad": true
TypeScript에 의해 자동으로 로드되는 프로젝트 수를 줄입니다.
언어 및 환경
"target": "es2016"
내보낼 JavaScript에 대한 버전을 설정하고 호환되는 라이브러리 선언을 포함합니다.
"lib": []
목표 런타임 환경을 만드는 번들 라이브러리 선언 파일 목록을 지정합니다.
"jsx": "preserve"
생성될 JSX 코드를 지정합니다.
"experimentalDecorators": true
TC39 2단계 드래프트 데코레이터에 대한 실험적 지원을 활성화합니다.
"emitDecoratorMetadata": true
원본 파일의 데코레이터 선언에 대한 설계 유형 메타데이터를 내보냅니다.
"jsxFactory": ""
React JSX를 내보낼 때 사용되는 JSX 팩토리 함수를 지정합니다. 예: 'React.createElement' 또는 'h'
"jsxFragmentFactory": ""
React JSX를 내보낼 때 Fragments에 사용되는 JSX Fragment 참조를 지정합니다. 예: 'React.Fragment' 또는 'Fragment'.
"jsxImportSource": ""
'jsx: react-jsx*'를 사용할 때 JSX factory functions를 가져오는 데 사용되는 모듈 지정자를 지정합니다.
"reactNamespace": ""
'createElement'에 대해 호출된 객체를 지정합니다. 이는 'react' JSX를 출력하는 경우에만 적용됩니다.
"noLib": true
기본 lib.d.ts를 포함한 라이브러리 파일을 포함하지 않도록 설정합니다.
"useDefineForClassFields": true
ECMA스크립트 표준 호환 클래스 필드를 내보냅니다.
"moduleDetection": "auto"
모듈 형식의 JS 파일을 탐지하는 데 사용되는 방법을 제어합니다.
모듈
"module": "commonjs"
생성될 모듈 코드를 지정합니다.
"rootDir": "./"
소스 파일의 루트 폴더를 지정합니다.
"moduleResolution": "node"
주어진 모듈 지정자에서 TypeScript가 파일을 검색하는 방법을 지정합니다.
"baseUrl": "./"
모듈을 절대 경로 불러올 때의 기본 경로를 지정합니다.
"paths": {}
가져오기 별칭 목록을 지정합니다.
"rootDirs": []
모듈을 처리할 때 여러 폴더를 하나로 처리할 수 있게 합니다.
"typeRoots": []
'./node_modules/@types'와 같은 역할을 하는 폴더를 여러 개 지정합니다.
"types": []
소스 파일에서 참조되지 않았지만 포함시킬 타입 패키지를 지정합니다.
"allowUmdGlobalAccess": true
모듈에서 UMD globals에 액세스하는 것을 허용합니다.
"moduleSuffixes": []
모듈을 처리할 때 검색할 파일 이름 접미사 목록입니다.
"resolveJsonModule": true
.json 파일 가져오기를 활성화합니다.
"noResolve": true
TypeScript가 프로젝트에 추가할 파일의 수를 늘리지 못하도록 'import', 'require'또는 ''를 허용하지 않습니다.
JavaScript 지원
"allowJs": true
JavaScript 파일이 프로그램의 일부가 되도록 허용합니다. 이러한 파일에서 오류를 가져오려면 'checkJS' 옵션을 사용하십시오.
"checkJs": true
타입이 적용된 JavaScript 파일에서 에러 리포트를 활성화합니다.
"maxNodeModuleJsDepth": 1
'node_modules'에서 JavaScript 파일을 확인하는 데 사용되는 최대 폴더 크기를 지정하십시오. 'allowJs'에만 적용됩니다.
내보내기
"declaration": true
프로젝트의 TypeScript 및 JavaScript 파일에서 .d.ts 파일을 생성합니다.
"declarationMap": true
d.ts 파일에 대한 소스 맵을 만듭니다.
"emitDeclarationOnly": true
자바스크립트 파일은 출력하지 않고 d.ts 파일만 출력합니다.
"sourceMap": true
내보낸 JavaScript 파일에 대한 소스 맵 파일을 만듭니다.
"outFile": "./"
모든 출력을 하나의 JavaScript 파일로 번들하는 파일을 지정하십시오. 'declaration' 옵션이 true이면 모든 .d.ts 출력을 번들로 제공하는 파일도 지정합니다.
"outDir": "./"
내보내는 모든 파일에 대한 출력 폴더를 지정합니다.
"removeComments": true
주석을 내보내지 않습니다.
"noEmit": true
컴파일 과정에서 파일을 내보내지 않도록 설정합니다.
"importHelpers": true
헬퍼 함수를 파일별로 포함하지 않고 프로젝트별로 한 번씩 tslib에서 가져올 수 있습니다.
"importsNotUsedAsValues": "remove"
타입에만 사용되는 가져오기에 대한 내보내기/체크 동작을 지정합니다.
"downlevelIteration": true
반복을 위해 호환성은 더 높지만 상세하고 성능이 떨어지는 JavaScript를 출력합니다.
"sourceRoot": ""
디버거가 참조 소스 코드를 찾을 루트 경로를 지정합니다.
"mapRoot": ""
디버거가 생성된 위치 대신 맵 파일을 찾아야 하는 위치를 지정합니다.
"inlineSourceMap": true
내보낼 JavaScript에 소스 맵 파일을 포함합니다.
"inlineSources": true
내보낼 JavaScript 내부의 소스 맵에 소스 코드를 포함합니다.
"emitBOM": true
출력 파일의 시작 부분에 UTF-8 바이트 순서 표식(BOM)을 표시합니다.
"newLine": "crlf"
내보낼 파일의 줄 바꿈 문자를 설정합니다
"stripInternal": true
JSDoc 주석에 '@internal'이 있는 선언을 내보내지 않도록 설정합니다.
"noEmitHelpers": true
컴파일된 출력에서 '__extends'와 같은 사용자 지정 도우미 기능을 생성하지 않도록 설정합니다.
"noEmitOnError": true
유형 검사 오류가 보고된 경우 파일을 내보내지 않도록 합니다.
"preserveConstEnums": true
생성된 코드에서 'const enum' 선언을 지우지 않게 합니다.
"declarationDir": "./"
생성된 선언 파일의 출력 디렉터리를 지정합니다.
"preserveValueImports": true
JavaScript 출력에서 사용되지 않은 가져오기를 제거하지 않고 유지합니다.
인터롭 조건
"isolatedModules": true
각 파일이 다른 가져오기에 의존하지 않고 안전하게 트랜스파일될 수 있는지 확인합니다.
"allowSyntheticDefaultImports": true
모듈에 기본 내보내기가 없는 경우에도 'import x from y'를 허용합니다.
"esModuleInterop": true
CommonJS 모듈 가져오기를 지원하기 위해 추가 JavaScript를 출력합니다. 이렇게 하면 타입 호환성을 위해서 'allowSyntheticDefaultImports' 옵션을 사용할 수 있습니다.
"preserveSymlinks": true
실제 경로에 대한 심볼릭 링크를 처리하지 않도록 설정합니다. 이는 노드의 동일한 플래그와 관련이 있습니다.
"forceConsistentCasingInFileNames": true
가져올 때 케이스가 올바른지 확인합니다.
타입 검사
"strict": true
모든 엄격한 타입 검사 옵션을 사용합니다.
"noImplicitAny": true
암시적 'any' 타입을 사용한 표현식 및 선언에 대한 오류 보고를 표시합니다.
"strictNullChecks": true
타입 검사 시 'null'과 'undefined'를 고려합니다.
"strictFunctionTypes": true
함수를 할당할 때 매개 변수와 반환 값이 서브 타입과 호환되는지 확인합니다
"strictBindCallApply": true
'bind', 'call' 및 'apply' 메서드에 대한 인수가 원래 함수와 일치하는지 확인합니다.
"strictPropertyInitialization": true
선언되었지만 생성자에서 설정되지 않은 클래스 속성을 확인합니다.
"noImplicitThis": true
'this'의 타입이 'any'인 경우 오류 보고를 사용하도록 설정합니다.
"useUnknownInCatchVariables": true
기본 catch 절 변수는 'any'가 아닌 'unknown'입니다.
"alwaysStrict": true
'use strict'가 항상 배출되는지 확인합니다.
"noUnusedLocals": true
로컬 변수를 읽지 않은 경우 오류 보고를 활성화합니다.
"noUnusedParameters": true
함수 매개 변수를 읽지 않으면 오류가 발생합니다.
"exactOptionalPropertyTypes": true
'undefined'를 추가하는 대신 선택적 속성 유형을 작성된 것으로 해석합니다.
"noImplicitReturns": true
함수에서 명시적으로 반환되지 않는 코드 경로에 대해 오류 보고를 사용하도록 설정합니다.
"noFallthroughCasesInSwitch": true
switch 문의 fallthrough cases에 대해 오류 보고를 사용하도록 설정합니다.
"noUncheckedIndexedAccess": true
인덱스를 사용하여 액세스할 때 유형에 'undefined'를 추가합니다.
"noImplicitOverride": true
파생 클래스의 오버라이딩 메서드가 override 제어자로 표시되어 있는지 확인합니다.
"noPropertyAccessFromIndexSignature": true
인덱싱된 타입을 사용하여 선언된 키에 인덱싱된 접근자를 사용하도록 강제합니다.
"allowUnusedLabels": true
사용하지 않는 레이블에 대해 오류 보고를 사용하지 않도록 설정합니다.
"allowUnreachableCode": true
도달할 수 없는 코드에 대해 오류 보고를 사용하지 않도록 설정합니다.
완전성
"skipDefaultLibCheck": true
TypeScript에 포함된 .d.ts 파일 형식 검사를 건너뜁니다.
"skipLibCheck": true
모든 .d.ts 파일을 검사하는 형식을 건너뜁니다.
