如何定义含必填description键且值为string或null的TypeScript类型？

核心需求 #

要定义包含id、name、description的类型，其中description为必填字段，值允许是string或null；同时要让带description: null的对象合法，缺少description或name的对象不合法，还要处理ESLint对null的警告。

可行方案 #

方案1：调整ESLint规则（推荐） #

如果你的业务场景确实需要用null（比如和后端API交互时，要明确区分“主动设置为空”和“未提供字段”），可以修改ESLint的@typescript-eslint/no-null-keyword规则，允许使用null：
在你的ESLint配置文件（如.eslintrc.js）中添加：

module.exports = {
  // 其他配置项
  rules: {
    // 可以设为warn仅提示，或off直接关闭规则
    "@typescript-eslint/no-null-keyword": "off"
  }
};

之后你的原始类型定义就能正常使用，完全符合需求：

type Form = {
    id: string;
    name: string;
    // 必填字段，值允许string或null
    description: string | null;
};

// 合法：所有必填字段都已提供，description赋值为null
const validForm: Form = {
    id: 'q1',
    name: 'Test',
    description: null
};

// 不合法：缺少必填字段description
const invalidForm1: Form = {
    id: 'q1',
    name: 'Test'
};

// 不合法：缺少name和description两个必填字段
const invalidForm2: Form = {
    id: 'q1'
};

方案2：改用undefined并保持字段必填 #

如果必须遵循ESLint的建议用undefined，要注意：字段是否可选只和?有关，description: string | undefined依然是必填字段，你必须显式给它赋值（可以是undefined），不能省略：

type Form = {
    id: string;
    name: string;
    description: string | undefined;
};

// 合法：显式给description赋值为undefined
const validForm: Form = {
    id: 'q1',
    name: 'Test',
    description: undefined
};

// 不合法：缺少必填字段description
const invalidForm: Form = {
    id: 'q1',
    name: 'Test'
};

这个方案和你原本允许null的场景逻辑有差异，仅适合能接受用undefined替代null的场景。

关键说明 #

• TypeScript中，只有加?的字段才是可选的（如description?: string），description: string | undefined属于必填字段，必须显式赋值。
• ESLint的no-null-keyword是风格约束，不是TypeScript本身的语法限制，是否调整规则完全取决于业务场景的实际需求。

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