0Pricing
JavaScript Academy · 课时

命名、可读性与常见陷阱

学习命名和可读性指南；避免变量遮蔽、魔法数字和混合声明。

命名、可读性与常见陷阱 是 CoddyKit 上的免费 JavaScript Academy 课时。 这是第 3 节课，共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 JavaScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 JavaScript Academy 课程共包含 3 节课。

简介

目标：编写易读的代码。使用清晰的名称，避免使用魔法数字，并小心处理变量遮蔽。

  • 描述性名称
  • 为固定值使用常量
  • 避免意外的变量遮蔽
命名、可读性与常见陷阱 — 插图 1

清晰命名演示

根据变量保存的内容命名，而不是根据它们的使用方式命名。简短但清晰的名称更好。

// Use descriptive names
// Avoid single letters or vague words
const itemCount = 3;
const unitPrice = 5;

const totalPrice = itemCount * unitPrice;

console.log("Items:", itemCount);
console.log("Unit price:", unitPrice);
console.log("Total price:", totalPrice);
命名、可读性与常见陷阱 — 插图 2

命名指南

命名提示：

  • 数据使用名词（userName、totalPrice）
  • 函数使用动词（computeTotal）
  • 保持大小写风格一致（camelCase）
命名、可读性与常见陷阱 — 插图 3

避免魔法数字

将固定值提升为常量（通常使用 UPPER_CASE）。这样可以说明意图，也便于更新。

// Replace magic numbers with named constants
const TAX_RATE = 0.08;
const SUBTOTAL = 20;

const tax = SUBTOTAL * TAX_RATE;
const finalTotal = SUBTOTAL + tax;

console.log("Tax:", tax);
console.log("Final total:", finalTotal);
命名、可读性与常见陷阱 — 插图 4

变量遮蔽演示

变量遮蔽：内部变量使用相同的名称，从而隐藏外部变量。作用域嵌套时，请优先使用不同的名称。

// Shadowing: inner variable hides an outer one
let score = 10;

function addBonus() {
  // The next line creates a new "score" only inside this function
  let score = 5;
  console.log("Inner score:", score);
}

addBonus();
console.log("Outer score:", score);
命名、可读性与常见陷阱 — 插图 5

可读性检查清单

检查清单：

  • 每行表达一个想法
  • 使用短函数
  • 为固定值使用常量
  • 避免在不同作用域中重复使用名称
命名、可读性与常见陷阱 — 插图 6

命名最佳实践小测

快速检查：清晰命名。

命名、可读性与常见陷阱 — 插图 7

总结

总结：使用描述性名称，将固定值提升为常量，并避免变量遮蔽，让代码更易阅读和维护。

命名、可读性与常见陷阱 — 插图 8

常见问题解答

「命名、可读性与常见陷阱」课时是免费的吗？

是的 — 「命名、可读性与常见陷阱」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 JavaScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 JavaScript Academy 课程共包含 3 节课。

「命名、可读性与常见陷阱」这节课中我会学到什么？

学习命名和可读性指南；避免变量遮蔽、魔法数字和混合声明。 你通过在浏览器中直接运行的动手代码来练习 JavaScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 JavaScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 JavaScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 3 节。

「命名、可读性与常见陷阱」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 JavaScript Academy 课中编写并运行代码吗？

能。每节 JavaScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. let、const 与避免使用 var
  2. 块级、函数与模块作用域及 TDZ
  3. 命名、可读性与常见陷阱
← 返回 JavaScript Academy