Angular添加@nguniversal/express-engine报this.tree.readText不是函数

两个连续报错均由Angular生态依赖版本不匹配导致：

• 首次执行命令提示找不到@schematics/angular/utility/workspace，是因为当前项目内置的@schematics/angular版本过低，该工具方法是后续版本才新增的导出项，和你要安装的@nguniversal/express-engine版本要求不匹配。
• 手动安装@schematics/angular后出现的this.tree.readText is not a function报错，是因为单独安装的@schematics/angular版本过高，Angular DevKit在版本迭代中对Schematic的Tree API做了破坏性变更，readText方法在高版本中被移除/重构，和当前项目的Angular核心版本、CLI版本产生了API冲突。

注意：@schematics/angular是和Angular CLI、Angular核心包强绑定的内部依赖，不建议单独手动安装，非常容易出现版本错位。

按顺序操作即可修复：

• 先清理错误依赖缓存：删除项目下的node_modules文件夹，以及对应的锁文件（npm用户删package-lock.json，yarn用户删yarn.lock，pnpm用户删pnpm-lock.yaml）。
• 对齐Angular核心依赖版本：执行ng version查看当前项目@angular/core、@angular/cli的大版本号，执行ng update @angular/core @angular/cli --force将核心依赖升级到统一的兼容版本，该过程会自动安装匹配版本的@schematics/angular，无需手动操作。
• 安装对应版本的SSR包：执行ng add命令时，指定和当前Angular大版本完全一致的@nguniversal/express-engine版本。比如当前项目是Angular 15，就执行ng add @nguniversal/express-engine@15，跨大版本安装必然出现兼容问题。
• 如果上述操作完成后仍报API相关错误，检查全局Angular CLI版本：全局安装的@angular/cli大版本不能低于本地项目版本，也不要跨2个以上大版本，执行npm i -g @angular/cli@和本地项目一致的大版本号对齐全局版本即可，比如本地是Angular 16就执行npm i -g @angular/cli@16。

• Angular官方生态下的所有包（@angular/*、@nguniversal/*、@angular/material/*等）必须保持相同的大版本号，禁止混装不同大版本的包。
• 不要手动单独安装@schematics/angular、@angular-devkit/*这类CLI内部依赖，这类依赖会在安装对应版本@angular/cli时自动匹配安装，手动安装极易引发版本冲突。

内容的提问来源于stack exchange，提问作者RISHU GUPTA