Angular 18全局注册automapper-ts失败：app引用未定义

升级到Angular 18后，使用automapper-ts时，通过全局自执行函数注册Automapper会出现app变量未定义的错误，原代码如下：

var automapper = (function (app) {
    app.automapper = AutoMapperJs.AutoMapper.getInstance();   // ERROR: app未定义
    return app.automapper;
})(this);

问题原因 #

Angular 18默认采用ES模块（ESM）构建，在模块环境中全局上下文的this不再指向浏览器的window对象，而是undefined，所以传入自执行函数的app参数为undefined，导致赋值操作报错。

解决办法 #

• 改用ES模块方式引入注册
  安装automapper-ts后，在项目中创建一个全局初始化文件（比如automapper.config.ts），直接导入并初始化实例：

  import { AutoMapper } from 'automapper-ts';
  
  export const automapper = AutoMapper.getInstance();
  

  后续在组件或服务中直接导入这个实例即可使用。

• 显式绑定window对象
  如果需要保留全局注册的写法，修改自执行函数，直接传入window代替this：

  var automapper = (function (app) {
      app.automapper = AutoMapperJs.AutoMapper.getInstance();
      return app.automapper;
  })(window);
  

  注意：该方法仅适用于纯浏览器环境，若项目涉及服务端渲染（SSR），需额外判断环境避免window未定义的问题。

• 迁移至维护活跃的替代库
  automapper-ts已多年未更新，与Angular 18的ESM架构兼容性较差，建议迁移至@automapper/core + @automapper/angular组合，这是适配Angular生态的官方推荐方案，完全支持最新版本的模块系统和Angular特性。

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