JavaScript中变量同名覆盖非语法错误但易引发隐式行为，应使用let/const替代var以利用块级作用域和重复声明报错机制，配合ESLint no-shadow等规则提前拦截。
JavaScript 中变量同名覆盖本身不是语法错误，但容易引发隐式行为、作用域误判和调试困难。关键不在“避免所有重名”，而在于明确作用域边界、控制声明方式、识别潜在冲突。
用 let 和 const 替代 var，限制作用域泄漏
var 的函数作用域和变量提升（hoisting）是同名覆盖的常见源头。比如：
❌ 危险示例：
function example() {
var x = 10;
if (true) {
var x = 20; // 不报错，但覆盖了外层 x，且提升到函数顶部
}
console.log(x); // 输出 20，非预期
}
✅ 改进做法：
立即学习“Java免费学习笔记（深入）”；
- 统一使用
let（可重新赋值）或const（不可重声明）声明变量 - 它们具有块级作用域，同名声明会直接报错：
Identifier 'x' has already been declared - 强制开发者思考变量生命周期，避免无意覆盖
警惕函数参数与内部变量同名
函数参数在函数体内相当于 let 声明，若内部又用 let/const 声明同名变量，会报错；但若用 var 或直接赋值（无声明），则可能静默覆盖：
❌ 隐蔽问题：
function process(name) {
name = name.trim(); // 修改参数值 —— 可接受，但易混淆来源
if (someCondition) {
var name = "default"; // var 会提升，实际覆盖整个函数内的 name
}
}
✅ 更清晰写法：
- 参数名保持语义明确，内部需要新值时另起有意义的变量名（如
cleanName、fallbackName） - 禁用
var，改用const cleanName = name?.trim() || ""; - 必要时用解构重命名：
function process({ name: inputName }) { ... }
模块级与全局变量隔离，避免污染
在非模块环境（如直接 script 标签）中，顶层声明会挂到 window（浏览器）或 global（Node.js），极易被其他脚本覆盖。
✅ 安全实践：
- 始终启用模块模式（
<script type="module">或.mjs文件），模块顶层变量默认私有 - 不依赖全局变量传值，改用显式导出/导入：
export const API_BASE = "..."; import { API_BASE } from "./config.js"; - 若必须用全局，加唯一前缀或封装到命名空间对象：
MyApp.config = { timeout: 5000 };
借助工具提前发现潜在覆盖
人工检查易遗漏，可用静态分析守住底线：
- 开启 ESLint 规则：
no-shadow（禁止块级作用域内声明同名变量）、no-param-reassign（禁止修改参数） - TypeScript 编译器在严格模式下会对重复标识符、隐式 any、未声明变量等报错
- IDE 实时高亮（如 VS Code）对重复定义、未使用变量、作用域冲突有即时提示
变量同名不是绝对禁忌，比如循环中复用 i、回调里用 err 和 data 是合理惯例。核心是让覆盖行为可预见、可追溯、受约束——靠声明方式选对、作用域用清、工具兜底。
