如何在TypeScript项目中全局配置Luxon的throwOnInvalid设置？

方法1：全局配置文件 + 入口引入 #

这是最直接的方式，只需一次配置就能覆盖整个项目：

1. 新建一个全局配置文件，比如src/luxon-config.ts：

import { Settings } from "luxon";

// 开启throwOnInvalid，恢复toISO()返回string的原有行为
Settings.throwOnInvalid = true;

// 扩展Luxon的TypeScript类型，让编译器识别配置生效
declare module 'luxon' {
  interface TSSettings {
    throwOnInvalid: true;
  }
}

2. 在项目的入口文件（如main.ts、index.ts）中引入这个配置文件：

import './luxon-config';
// 后续业务代码...

这样所有文件中调用toISO()时，TypeScript都会推断其返回类型为string，且运行时会保持原有抛出错误的行为。

方法2：分离运行时配置与全局类型声明 #

如果希望类型声明无需每个文件引入即可生效，可以单独处理类型部分：

1. 新建全局类型声明文件，比如types/luxon/index.d.ts：

declare module 'luxon' {
  interface TSSettings {
    throwOnInvalid: true;
  }
}

2. 修改tsconfig.json，确保TypeScript能识别这个自定义类型目录：

{
  "compilerOptions": {
    "typeRoots": ["./types", "./node_modules/@types"]
  }
}

3. 仍需在项目入口引入包含Settings.throwOnInvalid = true的配置文件（同方法1的第一步），因为运行时的配置必须执行才能生效。

关键说明 #

• 运行时配置：Settings.throwOnInvalid = true必须在项目启动时执行一次，否则运行时仍会返回null而非抛出错误。
• 类型扩展：全局类型声明让TypeScript在整个项目中自动识别throwOnInvalid的配置，避免每个文件重复编写模块声明。

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