JavaScript大小写敏感吗?变量、函数与关键字的区分规则

作者:代码拾荒

时间:2026-11-22

浏览:177

详细解答JavaScript是否区分大小写,系统说明关键字、变量名、函数与内置对象、对象属性以及HTML边界的大小写规则,并附常见报错排查步骤。

文章目录
JavaScript大小写敏感吗?变量、函数与关键字的区分规则
图 0:JavaScript 在关键字、变量与函数层面的大小写区分缩略概览

JavaScript 是严格区分大小写(case-sensitive)的编程语言。无论是语言内置的关键字、自己声明的变量和函数,还是对象上的属性与方法,只要字母的大小写不同,JavaScript 引擎就会把它们当作完全不同的标识符处理。下面按关键字、变量、函数与内置对象,以及容易混淆的网页环境边界,逐一说明具体规则和排查方法。

关键字:必须全小写才能被引擎识别

ECMAScript 规范中定义的所有语法关键字和保留字全部采用小写字母,例如 if、else、for、while、let、const、var、function、return,以及字面量 true、false、null。JavaScript 解析器在读取代码时不会自动把大写字母转为小写,只有拼写完全一致的全小写词才会被识别为语法关键字。

如果在代码里把关键字的首字母或全部字母写成大写,引擎会直接把它当成普通变量名或语法错误。以下示例可在浏览器的开发者工具控制台(Console)或 Node.js 环境中运行验证:

// 正确写法:关键字全小写
let score = 85;
if (score >= 60) {
  console.log("及格");
}

// 错误写法 1:If 不被识别为条件关键字
If (score >= 60) {
  console.log("及格");
}
示例输出SyntaxError: Unexpected token '{'
// 错误写法 2:True 被当成未声明的变量名
let isPass = True;
示例输出ReferenceError: True is not defined

同样是关键字大小写写错,为什么上面两个例子报的错不一样?原因在于解析器的处理流程:If (...) { ... } 看起来像一次函数调用后面紧跟花括号,语法结构不合法,因此在解析阶段就直接报 SyntaxError;而 True 出现在赋值右侧,符合变量引用的语法位置,引擎会先接受它作为一个普通标识符,等到运行时找不到名为 True 的变量,才抛出 ReferenceError。

JavaScript大小写敏感吗?变量、函数与关键字的区分规则
图 1:JavaScript 词法分析器识别关键字与触发报错的步骤说明
容易顺带写错的特殊值:null 和 undefined 都是全小写,但表示“非数字”的 NaN(两个 N 大写、a 小写)和表示“无穷大”的 Infinity(首字母大写)采用混合大小写,写成 nan 或 infinity 会报 ReferenceError。

变量名与常量名:大小写不同就是两个独立的变量

在同一个作用域中,只要变量名里有一个字母的大小写不同,JavaScript 就会为它们分配各自独立的存储位置,彼此不会覆盖。下面的示例演示了 userName、username 和 USERNAME 同时存在时的表现:

let userName = "林涛";
let username = "陈晨";
const USERNAME = "GUEST";

console.log(userName);
console.log(username);
console.log(USERNAME);
示例输出林涛
陈晨
GUEST

语法允许它们共存,但实际编码中应避免只靠大小写区分不同变量,否则极易出现拼写错位。更隐蔽的问题发生在非严格模式下的赋值操作:如果你原本声明了 let userName = "林涛",后面不小心把赋值写成了 UserName = "周游"(首字母大写且没有加 let),JavaScript 在非严格模式下不会报错,而是会直接在全局作用域创建一个全新的 UserName 变量,原变量 userName 的值依然是 "林涛"。

// 非严格模式下的隐蔽失误
let userName = "林涛";
UserName = "周游"; // 首字母误写为大写,不会修改 userName

console.log(userName);
console.log(UserName);
示例输出林涛
周游

只要在脚本或函数顶部加上 "use strict";(或者使用现代 ES 模块,默认就是严格模式),上面那行未声明的 UserName = "周游" 就会立即抛出 ReferenceError: UserName is not defined,把拼写问题拦在当下。

JavaScript大小写敏感吗?变量、函数与关键字的区分规则
图 2:变量名大小写混用时的作用域存储机制与严格模式对比

顺带一提,JavaScript 社区常约定“普通变量用小驼峰(totalPrice),常量用全大写下划线(MAX_RETRY)”。这属于可读性规范而非语法强制要求:把 const maxRetry = 3 写成小驼峰同样合法,关键是在同一个项目里保持统一,减少猜测某个单词是否大写的机会。

函数名与内置方法:调用、定义和内置对象都要核对大小写

自定义函数的命名规则与变量完全一致:getUserInfo() 和 getuserinfo() 在引擎眼里是两个毫无关系的函数。此外,行业里通常把构造函数和类(class)写成大驼峰(如 UserProfile),普通函数写成小驼峰(如 createUser),调用时必须严格按照定义时的大小写来写。

比起自定义函数,初学者更常栽在 JavaScript 的内置对象与标准方法上,因为这些名字是语言或浏览器环境预先规定好的,大小写经常混杂着驼峰和全大写缩写:

  • 全局工具对象:Math、JSON、Date、Array、Object、Promise。注意 Math 首字母大写,JSON 四个字母全大写,写成 math.max() 或 Json.parse() 都会直接报 ReferenceError。
  • 内置方法名:通常采用小驼峰,例如 console.log()、Array.isArray()、JSON.stringify()、parseInt()、setTimeout()。其中 parseInt 的 I 大写,而 typeof 是全小写关键字。
  • 浏览器 DOM 方法:例如 document.getElementById()、document.querySelectorAll()、element.addEventListener()。最容易写错的是 getElementById 末尾的 Id——I 大写、d 小写,写成 getElementByID 会报错。
// 观察内置对象、方法与属性误写后的三种不同表现
console.log(Math.max(3, 9)); // 正确:输出 9
console.log(Math.pi);        // 属性名误写(应为 Math.PI),不报错但返回 undefined

// 下方两行若取消注释运行,会分别抛出不同错误:
// math.max(3, 9);                // ReferenceError: math is not defined
// document.getElementByID("app"); // TypeError: document.getElementByID is not a function
示例输出9
undefined

注意看上面这组结果的区别,它是排查大小写错误非常实用的依据:对象名写错会报 ReferenceError;方法名写错时,对象存在但找不到对应函数,会报 TypeError: ... is not a function;而只读属性名写错(比如把 Math.PI 写成 Math.pi,或者把数组的 arr.length 写成 arr.Length),JavaScript 甚至不会报错,而是静默返回 undefined,导致后续计算变成 NaN。

JavaScript大小写敏感吗?变量、函数与关键字的区分规则
图 3:根据运行报错与返回值定位大小写拼写错误的排查步骤

对象属性、HTML 与文件边界:容易让人误判的地方

很多开发者在写网页时产生“JavaScript 好像有时也不区分大小写”的错觉,往往是因为把 JavaScript 代码和 HTML、CSS 或字符串混淆在了一起。把这几层拆开看,边界非常清楚:

1. 普通对象属性与 JSON 键名

JavaScript 对象的属性名、JSON 数据的键名都严格区分大小写。来自后端接口的字段如果是 user.userId,在前端写成 user.userid 或 user.UserId 只会拿到 undefined。

const user = { name: "周游", Role: "admin" };
console.log(user.name); // "周游"
console.log(user.Name); // undefined
console.log(user.role); // undefined(原键名为大写 R 的 Role)
示例输出周游
undefined
undefined

2. HTML 标签与属性名 vs JavaScript DOM API

HTML 本身不区分大小写:在 HTML 文件中写 <DIV> 和 <div>,或者写 <button onClick="run()"> 和 <button onclick="run()">,浏览器都能正常解析并触发点击。但一旦进入 JavaScript 代码内部操作这个元素,规则立刻变为严格区分:

  • DOM 属性名:必须按规范大小写书写,例如 element.innerHTML(不是 innerHtml)、element.textContent、element.className。
  • 事件监听名称:通过 element.addEventListener("click", handler) 绑定标准点击事件时,事件名 "click" 必须全小写;如果写成 "Click",浏览器会把它当成另一个未知的自定义事件名,点击按钮时回调函数不会执行。
  • CSS 样式映射:CSS 文件里写 background-color 或 BACKGROUND-COLOR 都能生效,但在 JS 里通过 element.style 设置样式时,连字符要去掉并转为小驼峰 element.style.backgroundColor。

3. 字符串比较

JavaScript 中的字符串内容对比同样区分大小写,"JavaScript" === "javascript" 的结果是 false。在做验证码校验、搜索关键词过滤等不需要区分大小写的业务判断时,通常先把两边都转成小写再对比,例如 input.toLowerCase() === "yes"。

场景或语法要素 是否区分大小写 正确写法示例 常见误写及后果
JS 关键字 严格区分(全小写) if、return、const If(SyntaxError)、True(ReferenceError)
变量与自定义函数 严格区分 totalCount、getUser() TotalCount(非严格模式赋值变全局变量,或 ReferenceError)
内置对象与方法 严格区分 Math.PI、JSON.parse() Math.pi(undefined)、Json.parse()(ReferenceError)
对象属性与 JSON 键 严格区分 res.data.userId res.data.userid(得到 undefined)
JS DOM 属性与事件名 严格区分 innerHTML、"click" innerHtml(赋值无效或读取 undefined)、"Click"(不触发)
HTML 标签与 HTML 属性 不区分(HTML 规则) <div onclick="..."> <DIV onClick="..."> 在 HTML 中仍能工作,仅属写法不统一
JavaScript大小写敏感吗?变量、函数与关键字的区分规则
图 4:JavaScript 核心语法与 HTML / CSS 周边环境的大小写规则汇总对比

日常减少大小写报错的几个实用习惯

理解规则之后,只要养成几个简单的编码习惯,就可以把大小写失误降到最低:

  1. 开启严格模式或使用 ES 模块:在脚本顶部加上 "use strict";(或采用 <script type="module">),一旦不小心拼错已声明变量的大小写并赋值,引擎会立刻报 ReferenceError,而不会悄悄污染全局作用域。
  2. 不要仅靠大小写区分变量:避免在同一段代码里同时使用 data 和 Data、userName 和 username,即使语法合法,读代码和后期维护时也很容易看走眼。
  3. 多用编辑器的自动补全和 ESLint 检查:输入内置对象(如 document.get 或 Math.)时直接选补全提示,比手敲长方法名更不容易把 Id 误写成 ID。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章