TypeScript中number与Number的核心差异及本质定位解析

两类标识的直观运行时表现 #

TypeScript 中外观近似的两类 number 相关标识，行为存在本质区别：

• 全小写的 number 无法在运行时代码中直接访问，强行打印会触发静态检查报错：

console.log(number);
// 报错：error TS2693: 'number' only refers to a type

• 首字母大写的 Number 是 JavaScript 内置的全局构造器，作为真实运行时值可以直接访问，打印输出为标准函数描述：

console.log(Number);
// 输出：[Function: Number]

容易引发混淆的交叉特性 #

两类标识的边界模糊点很容易让开发者产生认知偏差，核心混淆场景包括：

1. 类型标注能力的交叉
   • number 是专门用于类型场景的标识，可直接用于变量、函数参数、返回值的类型标注，全程不参与运行时逻辑：

   var two: number = 2;
   function sqr(x: number) { return x * x; }
   

   • 作为内置构造器的 Number 同样支持被写在类型标注的位置，语法上不会触发报错：

   var two: Number = 2;
   

2. 运行时属性的认知差
   开发者熟悉的 TypeScript 用户自定义类，会同时具备双重属性：既可以作为类型标注使用，也可以作为真实运行时值直接访问（打印时会输出对应构造器的函数描述）。但小写的 number 完全不具备运行时值属性，仅存在于编译期的类型系统层面。
   这种混淆并非个例，全小写/首字母大写的类型配对（如 string 与 String、boolean 与 Boolean、symbol 与 Symbol）都存在完全一致的表现逻辑。

两类标识的本质差异 #

• 全小写原生类型（number、string 等）：是 TypeScript 编译期类型系统的专用标识，不对应任何运行时的真实实体，作用是描述 JavaScript 原始值的类型特征，仅在静态检查阶段参与逻辑校验，编译完成后会被完全擦除，不会出现在最终生成的 JavaScript 产物中。
• 首字母大写内置构造器（Number、String 等）：是 JavaScript 语言原生提供的全局构造函数，具备完整的运行时能力（可直接调用、挂载静态方法、生成原始值的对象包装实例）。当它被用于 TypeScript 类型标注位置时，指代的是「原始值对应的对象包装实例」的类型，和全小写原生类型描述的裸原始值类型并不等价。

实际开发中优先使用全小写的原生类型做类型标注，更贴合 JavaScript 原始值的日常使用场景，能避免不必要的包装对象类型引发的兼容问题。

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