为什么我的JavaScript代码在ESLint中报错 ‘no-undef’？

シ晶晶提问于 2026-01-29 20:16:24 阅读 37

前端

大家好，我在用ESLint检查代码时遇到了一个奇怪的问题。当我这样写配置函数的时候：


function init() {
  console.log(myConfig.apiKey); // 这里报错
}
init();

控制台会提示’myConfig’ is not defined。但myConfig明明在全局变量里定义过了，其他文件都能正常引用。我试过检查拼写和文件引入顺序，都没发现问题。难道是代码规范配置里漏了什么设置？

我来解答赞 5 收藏

反馈

2 条解答

Dev · 小倩 Lv1

ESLint 报 no-undef 是因为它没识别到你的全局变量。你得在 ESLint 配置里声明 myConfig 是全局变量才行。

/* eslint-env browser */

/* global myConfig */

加这两行注释，或者在 .eslintrc 文件里配置 globals：

{

  "globals": {

    "myConfig": "readonly"

  }

}

这样就不会再报错了。ESLint 默认不认你写的全局变量，得手动告诉它一声。

2026-02-03 21:04

UE丶志鸣 Lv1

这个问题挺常见的，主要是因为ESLint的规则和全局变量声明之间的关系没处理好。咱们一步步来解决。

第一步，先确认下你的myConfig是不是真的被定义为全局变量了。如果是在某个文件里直接写的var myConfig = { apiKey: 'xxx' };，那确实是个全局变量，但ESLint可能不知道它存在。这是因为ESLint默认只会识别标准环境里的全局变量（比如浏览器环境里的window、document之类的），你自己加的全局变量需要特别告诉它。

第二步，修改.eslintrc.js或.eslintrc.json配置文件。你需要在globals选项里手动声明myConfig是一个全局变量，并且告诉ESLint它是只读还是可写。比如这样：



module.exports = {

  // 其他配置...

  globals: {

    myConfig: 'readonly' // 表示myConfig是全局变量，而且不能被重新赋值

  }

};

如果你的myConfig是可以被重新赋值的，就把readonly改成writable。

第三步，检查一下有没有更好的方式避免污染全局作用域。说实话，直接往全局扔变量并不是最好的做法，容易引起命名冲突。你可以考虑用模块化的方式管理这些配置。比如用ES6模块导出：



// config.js

export const myConfig = {

  apiKey: 'your-api-key-here'

};



// 在其他文件中引入

import { myConfig } from './config.js';

console.log(myConfig.apiKey);

这样既解决了全局变量的问题，也让你的代码更清晰易懂。

最后吐槽一句，ESLint有时候确实有点“管得宽”，但它的本意是为了帮你写出更规范、更安全的代码。虽然一开始可能会觉得麻烦，但从长远看还是很值得的。

2026-01-30 09:11