关键在于“在哪声明”和“用什么方式声明”，应启用严格模式、优先使用ES模块、用IIFE封装非模块代码、慎用var而坚持let/const块级作用域。
关键不是“怎么声明”，而是“在哪声明”和“用什么方式声明”。不加约束地在顶层写 var x = 1、let y = 2，甚至漏掉关键字直接写 z = 3，都会让变量悄悄进入全局作用域——浏览器里就是 window.z，Node.js 里是 global.z。污染一旦发生，轻则覆盖他人变量，重则引发难以复现的运行时错误。
启用严格模式（"use strict"）
这是最基础、最有效的第一道防线。在脚本顶部或函数开头加上：
-
"use strict";会让隐式全局赋值（比如没声明就直接赋值count = 10）直接抛出ReferenceError，而不是默默挂到window上 - 它同时禁止一些不安全语法，比如删除不可配置属性、使用保留字作变量名等，间接提升代码健壮性
- 建议每个文件都开启，ES 模块默认已是严格模式，但传统
<script></script>标签仍需手动添加
优先使用模块化（ES Module）
现代前端开发中，ES 模块天然隔离顶层作用域：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 在
.js文件中使用export/import，该文件的顶层变量、函数、类默认不会暴露到全局 - 即使写
const config = { api: '...' };，也不会变成window.config，真正实现“所见即所得”的作用域边界 - 搭配构建工具（如 Vite、Webpack）或原生支持（现代浏览器、Node.js ≥14），零配置即可启用
用 IIFE 封装非模块化代码
针对老项目、第三方插件或无法改造成模块的脚本，立即执行函数表达式（IIFE）仍是可靠方案：
立即学习“Java免费学习笔记（深入）”；
- 写法简洁：
(function() { let data = []; function init() { /*...*/ } })(); - 所有内部声明的变量、函数仅在此函数作用域内有效，彻底与全局隔绝
- 如需有限暴露，可显式挂载到
window下一个命名空间对象中，例如window.MyLib = { version: '1.0', utils: {...} };，避免散落多个全局标识符
慎用 var，坚持 let/const + 块级作用域
变量声明方式直接影响作用域行为：
-
var存在变量提升且函数级作用域，容易误判生命周期；let和const是块级作用域，配合{}能精准控制可见范围 - 哪怕只是临时逻辑，也推荐包裹在
if、for或独立代码块中，例如：{ const temp = getValue(); process(temp); } - 避免在函数外直接声明变量——除非明确需要全局配置，且已统一收口到命名空间对象中
