AMD编译的TypeScript项目中，如何识别UMD全局变量Lodash的_？

这个问题我碰到过好多次了——当你用AMD编译TS项目，同时又依赖已通过UMD脚本引入的全局库时，确实很容易踩import触发动态加载的坑。下面给你几个靠谱的解决方案，按需选就行：

直接在你的tsconfig.json里的compilerOptions中添加"allowUmdGlobalAccess": true。开启这个选项后，TypeScript会自动识别那些带有UMD类型定义的库（比如你装的@types/lodash）所暴露的全局变量。这时候你不需要写任何import语句，直接在代码里用_就行，TS会自动关联上lodash的完整类型，而且不会生成任何AMD加载的代码，完全不破坏你现有的全局引入逻辑。

举个tsconfig的配置示例：

{
  "compilerOptions": {
    "module": "AMD",
    "target": "ES5",
    "allowUmdGlobalAccess": true,
    "typeRoots": ["./node_modules/@types"]
  },
  "include": ["./src/**/*"]
}

如果不想修改tsconfig，或者需要更精细的控制，可以创建一个全局类型声明文件（比如src/global.d.ts），在里面把全局变量_和lodash的类型关联起来：

declare const _: typeof import("lodash");

然后确保你的tsconfig.json的include字段包含这个文件，或者把它放在TypeScript能自动识别的类型目录下。这样整个项目里的所有文件都能直接用_，TS也能正确识别它的类型，同样不会触发任何AMD加载逻辑。

如果只是个别文件需要用到lodash的类型，不想全局配置，可以用import type只导入类型（不会生成实际的JS导入代码），然后断言全局变量的类型：

// 只导入类型，不会产生AMD加载代码
import type * as Lodash from "lodash";

// 断言全局的_是lodash类型
const _ = window._ as typeof Lodash;

// 现在可以正常用_，TS会提供完整的类型提示
_.debounce(() => console.log("hello"), 1000);

这个方法的好处是不会污染全局类型，只在当前文件生效。

• 一定要确保在HTML里先加载lodash.min.js，再加载你的AMD编译后的脚本，不然运行时会找不到_变量。
• 确保@types/lodash的版本和你实际引入的lodash版本匹配，避免类型不兼容的问题。
• 如果你用的是其他UMD库（比如moment），这些方案同样适用——比如方案一里开启allowUmdGlobalAccess后，moment全局变量也会被TS自动识别类型。

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