JavaScript / TypeScript 中 `null` 与 `undefined` 使用规范

一、目的

为了提升代码一致性、可读性和可维护性,统一团队中 nullundefined 的使用场景与规则,避免混乱与隐患。

二、概念区分

类型 含义 说明
undefined 系统默认的"未赋值"状态 通常由 JavaScript 引擎自动赋值
null 明确表示"空"或"无值" 由程序员主动赋值,表达"空"或"无效"状态

三、使用规范

1. 变量初始化

  • 使用 null 初始化非基本类型变量(对象、数组、引用):

    ini 复制代码
    let user: User | null = null;
    let items: Item[] | null = null;
  • 禁止手动将变量赋为 undefined,未初始化变量默认为 undefined 即可。

2. 对象属性缺省/清空

  • 对象属性可初始化为 null,表示"暂时为空":

    csharp 复制代码
    interface Profile {
      avatarUrl: string | null;
    }
  • 禁止将对象属性赋为 undefined,使用 null 代替。

3. 函数参数与返回值

  • 返回值为空时建议返回 null,避免使用 undefined

    bash 复制代码
    function findUser(id: number): User | null {
      return users[id] ?? null;
    }
  • 函数可选参数应使用 ? 来声明,而非 | undefined

    php 复制代码
    function greet(name?: string) {
      const realName = name ?? 'Guest';
    }

4. 判断空值

  • 判断变量是否为"空"时,使用宽松等于 == null

    ini 复制代码
    if (value == null) {
      // 相当于 value === null || value === undefined
    }
  • 避免使用 typeof value === 'undefined',除非在处理全局变量或 window 属性。

5. 清除引用(优化垃圾回收)

  • 使用 null 显式清除引用,有助于垃圾回收:

    ini 复制代码
    largeObject = null;
  • 不推荐使用 delete obj.prop,可使用 obj.prop = null

四、禁止示例

以下写法不符合规范:

ini 复制代码
// 不推荐
let data = undefined;
obj.value = undefined;
return undefined;

// 推荐
let data: SomeType | null = null;
obj.value = null;
return null;

五、TypeScript 类型声明建议

  • 对于可能缺省的变量或返回值,使用 | null 明确标注:

    csharp 复制代码
    let token: string | null = null;
  • 函数参数若为可选项,应使用 ? 而非 | undefined

    bash 复制代码
    function load(id?: number) { ... }

六、配套 ESLint 规则建议(可选)

perl 复制代码
{
  "rules": {
    "no-undefined": "error", // 禁止手动使用 undefined
    "@typescript-eslint/strict-boolean-expressions": "warn",
    "@typescript-eslint/no-unnecessary-condition": "warn"
  }
}

七、总结原则

  • 程序员主动赋值请使用 null
  • 系统默认缺省状态使用 undefined,无需手动赋值。
  • 清除对象引用时使用 null,有助于垃圾回收。
  • 判断空值时使用 == null,可同时判断 nullundefined
  • 类型声明中建议优先使用 | null,参数可选用 ?
相关推荐
独立开阀者_FwtCoder几秒前
面试官:为什么在 Vue3 中 ref 变量要用 .value?
前端·javascript·vue.js
NetX行者3 分钟前
基于Vue 3的AI前端框架汇总及工具对比表
前端·vue.js·人工智能·前端框架·开源
独立开阀者_FwtCoder4 分钟前
手握两大前端框架,Vercel 再出手拿下 Nuxt.js,对前端有什么影响?
前端·javascript·vue.js
独立开阀者_FwtCoder4 分钟前
弃用 html2canvas!快 93 倍的截图神器!
前端·javascript·vue.js
weixin_3993806919 分钟前
TongWeb8.0.9.0.3部署后端应用,前端访问后端报405(by sy+lqw)
前端
伍哥的传说39 分钟前
H3初识——入门介绍之常用中间件
前端·javascript·react.js·中间件·前端框架·node.js·ecmascript
AA-代码批发V哥41 分钟前
JavaScript之数组方法详解
javascript
洛小豆1 小时前
深入理解Pinia:Options API vs Composition API两种Store定义方式完全指南
前端·javascript·vue.js
Jokerator1 小时前
Vue 2现代模式打包:双包架构下的性能突围战
javascript·vue.js
洛小豆1 小时前
JavaScript 对象属性访问的那些坑:她问我为什么用 result.id 而不是 result['id']?我说我不知道...
前端·javascript·vue.js