升级Angular CLI后出现getMutableClone弃用警告，如何解决？

问题说明 #

这个警告是Angular编译器API在v4.0.0版本的兼容性变动：getMutableClone方法被移除，官方要求改用factory.update...系列方法来修改AST节点，同时禁止手动设置parent属性，注释和源映射范围用专门的方法处理。

解决步骤 #

• 定位调用位置：全局搜索项目代码（包括自定义schematics、编译器插件）中的getMutableClone，找到所有使用该方法的地方。
• 替换为factory.update...方法：
  根据你要修改的AST节点类型，选择对应的update方法（比如updateClassDeclaration、updateImportDeclaration、updateMethodDeclaration等），直接基于原节点生成修改后的新节点，无需克隆后再修改。
  示例代码对比：
  旧代码：

  import { getMutableClone } from '@angular/compiler';
  const clonedNode = getMutableClone(originalClassNode);
  clonedNode.name = factory.createIdentifier('UpdatedClassName');
  

  新代码：

  const updatedNode = factory.updateClassDeclaration(
    originalClassNode,
    originalClassNode.decorators, // 保留原装饰器
    originalClassNode.modifiers, // 保留原修饰符
    factory.createIdentifier('UpdatedClassName'), // 修改名称
    originalClassNode.typeParameters, // 保留原类型参数
    originalClassNode.heritageClauses, // 保留原继承/实现
    originalClassNode.members // 保留原类成员
  );
  

• 处理注释与源映射：
  如果需要保留原节点的注释或源映射范围，使用setCommentRange或setSourceMapRange方法：

  import { setCommentRange } from '@angular/compiler';
  setCommentRange(updatedNode, originalClassNode);
  

• 检查第三方依赖：
  如果警告来自第三方依赖包，先查看该包是否有适配Angular CLI v4+的更新版本，升级即可。若暂无更新，可考虑给该依赖提交issue反馈，临时可锁定依赖版本（不建议长期使用）。

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