angular - Angular 编译器需要 TypeScript >=3.4.0 和 <3.5.0，但找到了 3.5.3

Question

当我执行 npm run build 时出现以下错误:

The Angular Compiler requires TypeScript >=3.4.0 and <3.5.0 but 3.5.3 was found instead.

我已经尝试分别执行以下操作:

npm install typescript@">=3.4.0 <3.5.0". Then deleted node_modules and package.json. Run npm install

npm update --force. Then deleted node_modules and package.json. Run npm install

我仍然收到错误:

我的 package.json 包含以下依赖项:

  "dependencies": {
    "@angular/animations": "8.1.0",
    "@angular/cdk": "^8.0.2",
    "@angular/cli": "^8.1.0",
    "@angular/common": "8.1.0",
    "@angular/compiler": "8.1.0",
    "@angular/core": "8.1.0",
    "@angular/forms": "8.1.0",
    "@angular/http": "7.2.15",
    "@angular/material": "^8.0.2",
    "@angular/platform-browser": "8.1.0",
    "@angular/platform-browser-dynamic": "8.1.0",
    "@angular/router": "8.1.0",
    "@ngx-translate/core": "^11.0.1",
    "@ngx-translate/http-loader": "^4.0.0",
    "angular-user-idle": "^2.1.2",
    "angular2-cookie": "^1.2.6",
    "core-js": "^2.6.7",
    "rxjs": "6.5.2",
    "rxjs-tslint": "^0.1.5",
    "stream": "0.0.2",
  },
  "devDependencies": {
    "@angular-devkit/build-angular": "^0.801.0",
    "@angular/compiler-cli": "8.1.0",
    "@angular/language-service": "8.1.0",
    "@types/jasmine": "~3.3.13",
    "@types/jasminewd2": "~2.0.6",
    "@types/node": "~12.6.1",
    "jasmine-core": "~3.4.0",
    "jasmine-spec-reporter": "~4.2.1",
    "protractor": "~5.4.2",
    "ts-node": "~8.3.0",
    "tslint": "~5.18.0",
    "typescript": "^3.4.5"
  }

ng --version 给出以下输出:

Angular CLI: 8.1.2
Node: 10.16.0
OS: win32 x64
Angular: 8.1.0
... animations, common, compiler, compiler-cli, core, forms
... language-service, platform-browser, platform-browser-dynamic
... router

Package                           Version
-----------------------------------------------------------
@angular-devkit/architect         0.801.2
@angular-devkit/build-angular     0.801.2
@angular-devkit/build-optimizer   0.801.2
@angular-devkit/build-webpack     0.801.2
@angular-devkit/core              8.1.2
@angular-devkit/schematics        8.1.2
@angular/cdk                      8.1.1
@angular/cli                      8.1.2
@angular/http                     7.2.15
@angular/material                 8.1.1
@ngtools/webpack                  8.1.2
@schematics/angular               8.1.2
@schematics/update                0.801.2
rxjs                              6.5.2
typescript                        3.5.3
webpack                           4.35.2

这里可能出了什么问题？

Answer 1

适用于 Angular 12

对于在最新版本的 Angular 12 上运行的项目，您应该使用 TypeScript v4.2.x 到 4.3.x

npm i -D typescript@4.3.5

适用于 Angular 11

对于在最新版本的 Angular 11 (11.2.x) 上运行的项目，它最高支持 TypeScript v4.1.5。

npm i -D typescript@4.1.5

适用于 Angular 10(截至 2020 年 6 月)

对于使用 Angular 10 的用户，请注意必须安装 TypeScript 3.9，因为维护人员已经安装了 removed support for TypeScript 3.8 .最安全的选择是安装最新版本的 TypeScript

npm i -D typescript@3.9.5

适用于 Angular 9(截至 2020 年 5 月)

对于在最新版本的 Angular 9 (v9.1.x) 上运行的项目，它最高支持 TypeScript v3.8.3。如果您使用的是比它更新的版本(例如 TypeScript v3.9.0)，您应该将其降级并安装支持的版本:

npm i -D typescript@3.8.3

对于在 Angular 9 早期版本(v9.0.x)上运行的项目，支持的 TypeScript 版本为 TypeScript v3.6.5 到 v3.7.5(含)。安装任何其他不受支持的版本(例如 3.8.3)会导致类似于以下的错误:

ERROR in The Angular Compiler requires TypeScript >=3.6.4 and <3.8.0 but 3.8.3 was found instead

要修复它，您应该安装错误消息中所述的受支持版本。我建议您安装 Typescript 3.7.x，因为这将解锁有用的功能，例如可选链接和空值合并。

npm i -D typescript@3.7.5

或者，您可以简单地将 Angular 更新到最新的次要版本 (v9.1.x)，因为这不应包含任何重大更改。

---

适用于 Angular 8(原始答案)

您似乎安装了最新版本 (v3.5.3) 的 TypeScript。您应该安装 TypeScript v3.4.5，这是 Angular 8 支持的版本。

您可以尝试使用此命令安装特定版本的 TypeScript，而不是最新版本。

npm i -D typescript@3.4.5

此外，您可能需要考虑更改 package.json 上 TypeScript 版本的插入符号 ^:

• 完全删除它意味着它将阻止 npm 安装/使用最新的次要版本 (3.5.3)。

  “ typescript ”:“3.4.5”

• 将其更改为“~”会告诉 npm 任何补丁版本都是可以接受的

  "typescript": "~3.4.5"//将使用匹配 3.4.X 的最新版本

有关使用 npm 包版本控制的更多信息:https://docs.npmjs.com/about-semantic-versioning

---

适用于使用旧 Angular 版本的人, 比如 Angular 2 到 7

|-----------------|--------------------|
| Angular version | TypeScript version |
|-----------------|--------------------|
|       6.1.x     |       3.6.x        |
|-----------------|--------------------|
|       7.2.x     |       2.9.x        |
|-----------------|--------------------|                                 

同样，如果我们使用任何其他 Angular 版本，您可以安装相应的 TypeScript 版本。

npm i -D typescript@3.6.4

Source - 请参阅每个 Angular 版本支持的 TypeScript 版本的完整列表。

---

其他有用信息

实际上有一种方法可以安装项目中安装的 Angular 版本“不支持”的 TypeScript 版本，正如 felipesilva 所指出的那样.这样做的一个好处是允许您在项目中安装最新版本的 TypeScript(例如 TypeScript 4.1.2 或任何测试版)。

在您的 tsconfig.json 上，您只需将 disableTypeScriptVersionCheck 设置为 true。

{
  // ...
  "angularCompilerOptions": {
    // ...
    "disableTypeScriptVersionCheck": true
  }
}

但是，请注意 official Angular documentation 不建议这样做:

Not recommended, as unsupported versions of TypeScript might haveundefined behavior.