TypeScript 2.6中Moment.js v2.13.0导入失败求助

解决Moment.js指定版本安装与TypeScript 2.6导入报错问题 #

我来帮你一步步搞定这个问题，不管是安装指定版本的Moment.js，还是解决TypeScript 2.6下的导入报错，都给你理清楚：

一、安装指定版本的Moment.js及对应类型定义 #

老版本的Moment.js和它的TypeScript类型定义是严格对应的，所以要精确安装匹配的版本，避免类型不兼容：

安装Moment.js v2.13.0及对应@types

在项目根目录执行以下命令：

npm install moment@2.13.0 --save
npm install @types/moment@2.13.0 --save-dev

安装Moment.js v2.14.1及对应@types

如果需要切换到v2.14.1，执行：

npm install moment@2.14.1 --save
npm install @types/moment@2.14.1 --save-dev

注意：不要给@types版本加^，因为老版本的类型定义可能会有不兼容的小版本更新，精确指定版本更稳妥。

二、解决TypeScript 2.6下的"cannot find the name moment"报错 #

TypeScript 2.6是比较早期的版本，和新版本TS的导入规则有差异，你之前的导入方式都踩了坑，这里给你两种可行的方案：

方案1：使用默认导入（推荐）

Moment.js的默认导出就是它本身，老版本的类型定义也适配这种方式，修改你的导入代码为：

import moment from 'moment';

// 现在可以正常使用了
const currentTime = moment().format('YYYY-MM-DD');

同时要确保你的tsconfig.json里开启了allowSyntheticDefaultImports，这是TS2.6支持默认导入的必要配置：

{
  "compilerOptions": {
    "module": "commonjs", // 适配Node.js环境，根据你的项目调整
    "allowSyntheticDefaultImports": true,
    "target": "es5" // 或者你需要的ECMAScript目标版本
  }
}

方案2：全局导入+命名空间使用

有些老版本的@types/moment会把moment挂载到全局命名空间，这时候可以直接导入模块并使用：

// 先导入模块，让TS识别类型
import 'moment';

// 直接使用全局的moment变量
const now = moment();

这种情况下，要确保tsconfig.json的types配置包含moment，让TS自动加载类型定义：

{
  "compilerOptions": {
    "types": ["moment"]
  }
}

为什么你之前的导入方式失败？ #

• import { moment } from 'moment';：错误，因为Moment.js没有暴露名为moment的命名导出，它的导出是默认导出。
• import * as moment from 'moment';：在TS2.6中，老版本的Moment.js类型定义可能不兼容这种命名空间导入方式，所以会报错。

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