变量提升本身不直接导致冲突，真正问题是同名变量在不同作用域重复声明及访问时机错位；应使用let/const替代var，利用TDZ报错机制和块级作用域隔离来规避。
变量提升本身不会直接导致冲突，真正引发问题的是 同名变量在不同作用域中被重复声明，加上提升后访问时机错位。避免冲突的关键不是阻止提升（它无法关闭），而是从声明方式、作用域设计和访问习惯三方面主动规避。
用 let/const 替代 var，堵住提升漏洞
var 的函数级提升 + 赋值不提升，容易造成“能读但值不对”的静默错误。let 和 const 虽然也存在声明提升，但引入了 暂时性死区（TDZ）：在声明语句执行前访问，直接报 ReferenceError，而不是返回 undefined。
-
console.log(a); let a = 1;→ 报错，强制你把使用放在声明之后 - 块级作用域天然隔离，
for (let i = 0; i 中的 <code>i不会泄漏到循环外 - const 还能防止意外重赋值，适合大多数场景
明确变量归属，避免同名遮蔽（shadowing）
函数内用 var x 声明，会遮蔽外层同名变量——这不是提升导致的，而是作用域查找规则决定的。提升只是让这个遮蔽提前生效了。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 不要在函数内无意重复使用全局或外层变量名，比如外层有
var count = 0，函数内就别再写var count - 如果确实需要基于外层值做计算，显式传参：
function calc(count) { ... }，而不是依赖闭包访问 - 命名带上下文，如
userCount、totalCount，降低重名概率
保持声明靠近首次使用，减少提升干扰
即使用了 let，把声明堆在函数顶部仍会增加理解成本。现代 JS 推荐就近声明：
立即学习“Java免费学习笔记（深入）”；
- 在
if块里要用的变量，就在if内部用let声明 - 循环变量统一用
for (let i...)，不用var i然后在循环外初始化 - 函数参数本身就是局部变量，无需额外声明同名变量覆盖
启用严格模式，拦截隐式全局
漏写 var/let/const 会导致变量自动挂到全局，这是比提升更隐蔽的冲突源。
- 在脚本或函数顶部加
'use strict'; - ES 模块默认严格模式，推荐用
import/export组织代码 - 配合 ESLint 规则（如
no-implicit-globals）提前发现风险
