VS2022's Angular and ASP.NET Core Template Is Stuck on Angular 19 — Here's the Workaround

Context

Visual Studio 2022의 Angular and ASP.NET Core 템플릿은 Angular CLI 19에만 호환되지만, Angular 20 이상으로 업데이트한 개발자들의 글로벌 환경에서는 프로젝트 생성이 실패한다. Microsoft 공식 문서에서도 Angular 20.x.x와의 호환성 문제를 인정했다.

Technical Solution

• Angular CLI 버전 확인: ng version 명령으로 현재 글로벌 설치 버전 확인
• 임시 다운그레이드: npm uninstall -g @angular/cli 후 npm install -g @angular/cli@19 실행
• 프로젝트 생성: Visual Studio 2022에서 Angular and ASP.NET Core 템플릿으로 프로젝트 생성
• 단계적 업그레이드: Angular 19 → 20 → 21 순서로 ng update @angular/core@XX @angular/cli@XX 실행 (버전 단계 건너뛰지 않음)
• 글로벌 CLI 복구: npm install -g @angular/cli@latest 실행하여 최신 버전으로 복구

Key Takeaway

템플릿 버전 호환성 불일치는 머신 설정 문제가 아니라 도구 자체의 뒤처짐이므로, 문제 원인 파악 후 임시 다운그레이드로 언제 해제할 수 있는 회피 경로를 마련하는 것이 중요하다.