安全声明和使用JavaScript全局变量需显式挂载到window、禁用隐式声明、区分常量与状态、优先模块化。浏览器中全局变量本质是window属性，应const/let声明后赋值window.xxx，开启"use strict"并用ESLint校验，避免污染与冲突。
安全地声明和使用 JavaScript 全局变量，核心是避免隐式挂载、明确作用域归属、防止意外覆盖。现代开发中全局变量本身应尽量减少，但当必须使用时（如配置项、工具函数、跨模块共享状态），需遵循浏览器环境的真实机制和工程规范。
明确用 window 显式挂载（浏览器环境）
在浏览器中，全局变量本质是 window 对象的属性。显式写成 window.xxx，既清晰又可控：
- 声明时直接赋值给
window：window.API_BASE_URL = "https://api.example.com"; - 访问时可简写为
API_BASE_URL，也可严格写成window.API_BASE_URL，后者更利于调试和静态分析 - 配合
const或let声明更安全（ES6+）：const APP_VERSION = "2.1.0"; window.APP_VERSION = APP_VERSION;—— 避免被意外重赋值
禁止隐式声明（不加 var/let/const 直接赋值）
这是最危险的习惯，尤其在非严格模式下：
- 例如：
userToken = "abc123";—— 无论写在函数内还是外，都会悄悄变成window.userToken - 问题：容易拼错变量名导致新建全局变量；与已有变量冲突；严格模式下直接报错
ReferenceError - 解决方案：始终开启
"use strict";，并在 ESLint 中启用no-implicit-globals规则
区分只读常量与可变全局状态
不是所有“全局东西”都该是变量。按用途分类处理：
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
立即学习“Java免费学习笔记（深入）”；
-
配置常量（如 API 地址、环境标识）：用
const声明 + 挂到window，或通过 TypeScript 的declare const提供类型提示 -
运行时状态（如用户登录态、主题偏好）：建议封装成单例对象，例如
window.__APP_STATE = { user: null, theme: "light" };，避免散落多个独立变量 -
工具函数（如
formatDate）：统一挂到命名空间下，如window.Utils = { formatDate() {}, debounce() {} };，降低污染风险
模块化优先，全局只是兜底
真正安全的做法，是让全局变量变得“可选”而非“必需”：
- 用 ES 模块（
import/export）组织代码，把需要共享的内容导出，而不是扔进全局 - 若需兼容旧环境，可用 IIFE 封装后有选择地暴露：
(function(){ const internal = ...; window.MyLib = { init() {} }; })(); - 构建工具（如 Webpack）支持
expose-loader或libraryTarget: "window"，比手写window.xxx更可靠
不复杂但容易忽略：全局变量的安全性，不取决于它“能不能被访问”，而在于它“是否被清晰定义、受控修改、有据可查”。
