TypeScript 项目如何配置 temporal-polyfill从 TS 5.x 到 6.0 的类型设置完整教程【免费下载链接】temporal-polyfillA lightweight polyfill for Temporal, successor to the JavaScript Date object项目地址: https://gitcode.com/gh_mirrors/tempo/temporaltemporal-polyfill 是 Temporal 标准的轻量级 polyfill作为 JavaScript 原生 Date 对象的继任方案压缩后仅有约 19.5 kB。在 TypeScript 项目中接入它时最容易被卡住的一环就是类型配置TS 5.x 与 TS 6.0 的配置方式截然不同。本教程将从安装、入口选择到 tsconfig.json 逐项讲解帮你一次搞定 TypeScript 项目中的 temporal-polyfill 类型设置彻底告别Cannot find name Temporal报错。一、为什么 TypeScript 项目需要 temporal-polyfillTemporal 是 TC39 推进的新一代日期时间 API用来替代设计上存在诸多缺陷的 Date 对象。但原生 Temporal 尚未覆盖所有运行环境因此需要 polyfill 提前尝鲜。temporal-polyfill 的核心优势轻量mingzip 仅约 19.5 kBfull 版本约 23.4 kB规范兼容与最新 Temporal 规范几乎完全一致仅有 2 处有意偏差智能降级运行环境已有原生 Temporal 时自动使用原生实现覆盖广支持 Node.js 16 及 Chrome 67、Firefox 68、Safari 14 等主流浏览器在 TypeScript 项目中除了安装运行时依赖还必须让 TypeScript 编译器与编辑器认识Temporal全局命名空间这就是类型配置要解决的核心问题。二、安装 temporal-polyfill 的最快方法在项目根目录执行npm install temporal-polyfill如果希望获取源码进行本地调试可以通过 git clone 克隆仓库仓库地址https://gitcode.com/gh_mirrors/tempo/temporal仓库内包含 polyfill、codemod、docs、spec 等多个子项目。三、先选入口global 还是 ponyfill⚠️类型配置方式取决于你选择的入口entrypoint。temporal-polyfill 提供多种导入方式最常见的几种如下入口示例代码适用场景全局 polyfill最常用import temporal-polyfill/global全项目直接使用Temporal局部导入ponyfillimport { Temporal } from temporal-polyfill模块内使用无全局副作用强制内置实现import { Temporal } from temporal-polyfill/implementation需要锁定非原生实现按需安装import { install } from temporal-polyfill/shim条件判断后再全局安装完整历法版本import temporal-polyfill/full/global需要佛历、农历、希伯来历等扩展历法使用全局入口/global时TypeScript 必须配置全局类型使用局部导入时则无需额外配置。下面分别讲解。四、TypeScript 6.0 的类型设置一行配置搞定 ✅从 TypeScript 6.0 开始Temporal类型被正式纳入 TypeScript 标准库。使用全局入口时只需在 tsconfig.json 中启用相关 lib 即可{ compilerOptions: { lib: [esnext] } }如果你的项目对 lib 粒度要求较高也可以按需组合{ compilerOptions: { lib: [esnext.temporal, esnext.intl, esnext.date] } }其中esnext.temporal提供Temporal命名空间的全部类型esnext.intl提供Intl.DateTimeFormat对 Temporal 对象的格式化扩展esnext.date提供Date.prototype.toTemporalInstant()的类型声明。五、TypeScript 5.x 及以下版本的类型配置方法 在 TS 5.x 中标准库还没有Temporal类型需要手动加载 temporal-polyfill 附带的全局类型声明文件。做法是在运行时入口之后追加一条类型导入import temporal-polyfill/global // 运行时入口 import temporal-polyfill/types/global // 类型声明入口顺序很重要先导入运行时入口再导入类型入口缺一不可。这条types/global类型入口由包内的polyfill/src/classApi/globalTypes.ts导出源码中该文件仅一行export * from temporal-spec/global底层依赖独立的类型包 temporal-spec位于仓库的spec/目录核心声明文件为global.d.ts它会在declare global中声明完整的Temporal命名空间扩展Intl.DateTimeFormat的format、formatToParts、formatRange等方法使其接受 Temporal 对象为Date接口补充toTemporalInstant()方法六、一张表看懂 TS 5.x 与 TS 6.0 的类型配置差异 对比项TypeScript 6.0TypeScript 5.x 及以下是否内置 Temporal 类型是esnext lib 已包含否需要的 tsconfig 配置lib: [esnext]或esnext.temporal等无需改 lib需要的代码改动无追加import temporal-polyfill/types/global出错时的典型报错lib 未启用导致类型缺失Cannot find name Temporal简单记忆TS 6.0 改配置TS 5.x 加导入。七、常见问题排查Temporal 类型报错怎么办1. 报错Cannot find name Temporal确认使用的是全局入口temporal-polyfill/global而不是局部 ponyfillTS 5.x 确认已追加import temporal-polyfill/types/globalTS 6.0 确认 tsconfig.json 中lib已包含esnext或esnext.temporal2. 报错Type Temporal must have a [Symbol.toStringTag] property这是 TS 5.x 项目忘记加载全局类型声明的典型信号按第五节方法追加类型导入即可。3. 局部导入时类型不全使用import { Temporal } from temporal-polyfill时类型由包的exports字段中的types指向typeOverrides/index提供正常 npm 安装即可生效无需额外配置。4. moduleResolution 兼容性temporal-polyfill 是 ESM 优先的包建议使用moduleResolution: Bundler现代构建工具或NodeNextNode 场景。仓库根目录的tsconfig.base.json采用的就是module: ESNext与moduleResolution: Bundler组合。八、进阶tree-shakeable fns API 的类型支持 如果项目对打包体积极其敏感temporal-polyfill 还提供面向 tree-shaking 的函数式 APIfns API每个 Temporal 类型对应一个独立入口例如temporal-polyfill/fns/PlainDate、temporal-polyfill/fns/ZonedDateTimeimport * as PlainDateFns from temporal-polyfill/fns/PlainDate const date PlainDateFns.create(2026, 6, 1) const later PlainDateFns.addMonths(date, 2)fns API 的每个入口都随包发布完整 TypeScript 类型声明无需额外配置即可获得类型提示且天然支持 tree-shaking打包器只会保留实际导入的函数。完整的函数目录与类型说明参见仓库docs/fns/index.md及docs/fns/下按类型划分的文档如plaindate.md、zoneddatetime.md。未来当原生 Temporal 全面普及后还可以借助仓库codemod/目录下的迁移工具将函数式调用自动重写回标准的Temporal.*写法。九、总结按 TS 版本对号入座即可 TS 6.0 项目tsconfig.json 中设置lib: [esnext]其余代码零改动TS 5.x 项目在全局入口之后追加import temporal-polyfill/types/global局部 ponyfill 用法两种 TS 版本都无需额外类型配置temporal-polyfill 将复杂的 Temporal 类型系统封装得相当省心只要按版本对号入座TypeScript 项目就能立刻获得完整的类型提示、编译期校验和自动补全。现在就去你的项目里试试吧【免费下载链接】temporal-polyfillA lightweight polyfill for Temporal, successor to the JavaScript Date object项目地址: https://gitcode.com/gh_mirrors/tempo/temporal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TypeScript 项目如何配置 temporal-polyfill？从 TS 5.x 到 6.0 的类型设置完整教程
TypeScript 项目如何配置 temporal-polyfill从 TS 5.x 到 6.0 的类型设置完整教程【免费下载链接】temporal-polyfillA lightweight polyfill for Temporal, successor to the JavaScript Date object项目地址: https://gitcode.com/gh_mirrors/tempo/temporaltemporal-polyfill 是 Temporal 标准的轻量级 polyfill作为 JavaScript 原生 Date 对象的继任方案压缩后仅有约 19.5 kB。在 TypeScript 项目中接入它时最容易被卡住的一环就是类型配置TS 5.x 与 TS 6.0 的配置方式截然不同。本教程将从安装、入口选择到 tsconfig.json 逐项讲解帮你一次搞定 TypeScript 项目中的 temporal-polyfill 类型设置彻底告别Cannot find name Temporal报错。一、为什么 TypeScript 项目需要 temporal-polyfillTemporal 是 TC39 推进的新一代日期时间 API用来替代设计上存在诸多缺陷的 Date 对象。但原生 Temporal 尚未覆盖所有运行环境因此需要 polyfill 提前尝鲜。temporal-polyfill 的核心优势轻量mingzip 仅约 19.5 kBfull 版本约 23.4 kB规范兼容与最新 Temporal 规范几乎完全一致仅有 2 处有意偏差智能降级运行环境已有原生 Temporal 时自动使用原生实现覆盖广支持 Node.js 16 及 Chrome 67、Firefox 68、Safari 14 等主流浏览器在 TypeScript 项目中除了安装运行时依赖还必须让 TypeScript 编译器与编辑器认识Temporal全局命名空间这就是类型配置要解决的核心问题。二、安装 temporal-polyfill 的最快方法在项目根目录执行npm install temporal-polyfill如果希望获取源码进行本地调试可以通过 git clone 克隆仓库仓库地址https://gitcode.com/gh_mirrors/tempo/temporal仓库内包含 polyfill、codemod、docs、spec 等多个子项目。三、先选入口global 还是 ponyfill⚠️类型配置方式取决于你选择的入口entrypoint。temporal-polyfill 提供多种导入方式最常见的几种如下入口示例代码适用场景全局 polyfill最常用import temporal-polyfill/global全项目直接使用Temporal局部导入ponyfillimport { Temporal } from temporal-polyfill模块内使用无全局副作用强制内置实现import { Temporal } from temporal-polyfill/implementation需要锁定非原生实现按需安装import { install } from temporal-polyfill/shim条件判断后再全局安装完整历法版本import temporal-polyfill/full/global需要佛历、农历、希伯来历等扩展历法使用全局入口/global时TypeScript 必须配置全局类型使用局部导入时则无需额外配置。下面分别讲解。四、TypeScript 6.0 的类型设置一行配置搞定 ✅从 TypeScript 6.0 开始Temporal类型被正式纳入 TypeScript 标准库。使用全局入口时只需在 tsconfig.json 中启用相关 lib 即可{ compilerOptions: { lib: [esnext] } }如果你的项目对 lib 粒度要求较高也可以按需组合{ compilerOptions: { lib: [esnext.temporal, esnext.intl, esnext.date] } }其中esnext.temporal提供Temporal命名空间的全部类型esnext.intl提供Intl.DateTimeFormat对 Temporal 对象的格式化扩展esnext.date提供Date.prototype.toTemporalInstant()的类型声明。五、TypeScript 5.x 及以下版本的类型配置方法 在 TS 5.x 中标准库还没有Temporal类型需要手动加载 temporal-polyfill 附带的全局类型声明文件。做法是在运行时入口之后追加一条类型导入import temporal-polyfill/global // 运行时入口 import temporal-polyfill/types/global // 类型声明入口顺序很重要先导入运行时入口再导入类型入口缺一不可。这条types/global类型入口由包内的polyfill/src/classApi/globalTypes.ts导出源码中该文件仅一行export * from temporal-spec/global底层依赖独立的类型包 temporal-spec位于仓库的spec/目录核心声明文件为global.d.ts它会在declare global中声明完整的Temporal命名空间扩展Intl.DateTimeFormat的format、formatToParts、formatRange等方法使其接受 Temporal 对象为Date接口补充toTemporalInstant()方法六、一张表看懂 TS 5.x 与 TS 6.0 的类型配置差异 对比项TypeScript 6.0TypeScript 5.x 及以下是否内置 Temporal 类型是esnext lib 已包含否需要的 tsconfig 配置lib: [esnext]或esnext.temporal等无需改 lib需要的代码改动无追加import temporal-polyfill/types/global出错时的典型报错lib 未启用导致类型缺失Cannot find name Temporal简单记忆TS 6.0 改配置TS 5.x 加导入。七、常见问题排查Temporal 类型报错怎么办1. 报错Cannot find name Temporal确认使用的是全局入口temporal-polyfill/global而不是局部 ponyfillTS 5.x 确认已追加import temporal-polyfill/types/globalTS 6.0 确认 tsconfig.json 中lib已包含esnext或esnext.temporal2. 报错Type Temporal must have a [Symbol.toStringTag] property这是 TS 5.x 项目忘记加载全局类型声明的典型信号按第五节方法追加类型导入即可。3. 局部导入时类型不全使用import { Temporal } from temporal-polyfill时类型由包的exports字段中的types指向typeOverrides/index提供正常 npm 安装即可生效无需额外配置。4. moduleResolution 兼容性temporal-polyfill 是 ESM 优先的包建议使用moduleResolution: Bundler现代构建工具或NodeNextNode 场景。仓库根目录的tsconfig.base.json采用的就是module: ESNext与moduleResolution: Bundler组合。八、进阶tree-shakeable fns API 的类型支持 如果项目对打包体积极其敏感temporal-polyfill 还提供面向 tree-shaking 的函数式 APIfns API每个 Temporal 类型对应一个独立入口例如temporal-polyfill/fns/PlainDate、temporal-polyfill/fns/ZonedDateTimeimport * as PlainDateFns from temporal-polyfill/fns/PlainDate const date PlainDateFns.create(2026, 6, 1) const later PlainDateFns.addMonths(date, 2)fns API 的每个入口都随包发布完整 TypeScript 类型声明无需额外配置即可获得类型提示且天然支持 tree-shaking打包器只会保留实际导入的函数。完整的函数目录与类型说明参见仓库docs/fns/index.md及docs/fns/下按类型划分的文档如plaindate.md、zoneddatetime.md。未来当原生 Temporal 全面普及后还可以借助仓库codemod/目录下的迁移工具将函数式调用自动重写回标准的Temporal.*写法。九、总结按 TS 版本对号入座即可 TS 6.0 项目tsconfig.json 中设置lib: [esnext]其余代码零改动TS 5.x 项目在全局入口之后追加import temporal-polyfill/types/global局部 ponyfill 用法两种 TS 版本都无需额外类型配置temporal-polyfill 将复杂的 Temporal 类型系统封装得相当省心只要按版本对号入座TypeScript 项目就能立刻获得完整的类型提示、编译期校验和自动补全。现在就去你的项目里试试吧【免费下载链接】temporal-polyfillA lightweight polyfill for Temporal, successor to the JavaScript Date object项目地址: https://gitcode.com/gh_mirrors/tempo/temporal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考