Q&A 피드 AI Workflow
VIBECODING 365 / Q&A
패키지 스크립트에서 typecheck 다음에 build를 돌리는 이유가 뭔가요?
typecheck를 build보다 먼저 실행하면 타입 오류를 조기에 차단해 잘못된 빌드 산출물을 막을 수 있습니다.
결론
typecheck 다음에 build를 실행하는 것은 타입 오류가 있는 코드로 빌드하지 않기 위한 안전장치입니다. 특히 AI가 코드를 생성하는 워크플로에서는 타입 환각, 잘못된 import, null 처리 누락이 자주 생기므로 이 순서가 중요합니다.
왜 이 순서인가
Fail Fast - 빨리 실패시키기
&&는 앞 명령이 성공할 때만 다음 명령을 실행합니다.
{
"scripts": {
"typecheck": "tsc --noEmit",
"build": "npm run typecheck && vite build"
}
}
실행 순서:
npm run typecheck실행- 타입 오류가 있으면 여기서 중단,
vite build는 실행되지 않음 - 타입 오류가 없으면 그때
vite build실행
이렇게 하면 깨진 코드를 배포하거나, 빌드 산출물을 만들지 않습니다.
빌더는 타입을 검사하지 않는다
Vite, esbuild, Babel 같은 빌더는 주로 변환과 번들링만 합니다. 타입 정보를 지우고 JavaScript로 바꾸는 과정에서 타입이 맞는지 검사하지 않습니다.
그래서 typecheck 없이 build만 돌리면 이런 문제가 생깁니다.
- 존재하지 않는 프로퍼티를 참조해도 빌드 성공
- 함수 인자 타입이 틀려도 빌드 성공
null또는undefined를 처리하지 않아도 빌드 성공- 실제 실행 시점에
TypeError로 터짐
tsc --noEmit는 파일을 만들지 않고 타입, import, 반환값, null 체크만 검사합니다. 빌드 전에 이 검사를 거치는 이유가 여기에 있습니다.
책임 분리
| 단계 | 역할 | 실패 시 의미 |
|---|---|---|
| typecheck | 타입, import, 문법, null 안전성 검사 | 코드 자체가 잘못됨 |
| build | 변환, 번들링, 압축, 정적 파일 생성 | 빌드 환경 또는 번들링 문제 |
두 단계를 분리하면 오류 원인을 빠르게 구분할 수 있습니다.
체크리스트
- [ ]
typecheck스크립트가tsc --noEmit또는 프로젝트에 맞는 타입 검사 명령인지 확인 - [ ]
build스크립트가typecheck성공 후에만 실행되도록&&로 연결했는지 확인 - [ ] CI, 배포, 프리뷰 환경에서도 같은
build명령을 사용하는지 확인 - [ ] 로컬에서는
npm run build한 번으로 타입 검사와 빌드가 모두 실행되는지 확인 - [ ] 타입 오류를 일부러 하나 만들어서 빌드가 중단되는지 테스트했는지 확인
직접 적용하는 방법
package.json의scripts에 typecheck를 분리합니다.
"typecheck": "tsc --noEmit"
- build를 아래처럼 연결합니다.
"build": "npm run typecheck && vite build"
- 로컬에서 순서대로 검증합니다.
npm run typecheck
npm run build
- 타입 오류가 있을 때 build가 중단되는지 확인합니다. 중단되지 않으면
&&연결이 잘못된 것입니다. - CI나 배포 설정에서도 별도로 build를 우회하지 않고 같은 스크립트를 사용합니다.
주의사항
&&대신;를 쓰면 앞 명령이 실패해도 build가 계속 실행되므로 사용하지 마세요.- typecheck는 빌드를 대체하지 못합니다. 타입이 맞아도 번들링, 에셋, 환경변수 문제로 build가 실패할 수 있습니다.
- 반대로 build 성공은 타입이 맞다는 뜻이 아닙니다. 그래서 배포 전에는 반드시 typecheck를 포함한 build를 실행하세요.
- AI로 코드를 생성한 뒤에는 특히
npm run build결과를 먼저 확인하고, 실패하면 타입 오류부터 수정한 뒤 다시 실행하세요.