Meteor包开发全局命名空间导出的ESLint配置问题

我之前开发Meteor包时也遇到过一模一样的问题——为了让api.export生效，必须在文件里全局声明变量，但ESLint的no-undef规则总报错，直接关掉规则又怕漏掉真正的未定义变量问题。下面几个方案亲测有效，你可以根据自己的需求选：

方案1：在ESLint配置中声明全局变量 #

这是最推荐的方案，适合包中有多个导出变量的场景。在你的包目录下的.eslintrc（或.eslintrc.json）文件里，添加globals字段，把需要导出的变量声明为全局可写变量：

{
  "rules": {
    // 保留你的其他规则配置
  },
  "globals": {
    "VariableName": true
  }
}

这里的true表示允许对这个全局变量进行赋值操作，正好匹配Meteor包中VariableName = { ... }的写法。如果有多个导出变量，直接在globals里添加多个键值对即可：

"globals": {
  "Utils": true,
  "AppConfig": true
}

这样配置后，ESLint会把这些变量视为合法的全局变量，既不会报错，又能保留no-undef规则对其他未定义变量的检查。

方案2：在单个文件顶部添加全局注释 #

如果你的包只有少数几个导出变量，或者不想修改全局ESLint配置，可以在对应的文件（比如main.js）顶部添加单行注释，告诉ESLint这个变量是全局的：

/* global VariableName */
VariableName = { /* 你的包内容 */ };

这种方式更灵活，只对当前文件生效，不会影响其他文件的规则检查。

为什么不能用let/const？ #

可能你会想，能不能用let VariableName = { ... }代替全局声明？答案是不行的——Meteor的api.export机制依赖于挂载到全局作用域的变量，用块级作用域的let/const声明的变量无法被包的导出系统识别，所以必须用全局赋值的方式。

内容的提问来源于stack exchange，提问作者Jankapunkt