微信小程序 ESLint 全局变量配置

微信小程序内置了大量全局 API（如 wx、Page、Component 等），ESLint 默认无法识别，会导致代码报错、标红，通过配置全局变量可完美解决。

一、.eslintrc.js 配置

在项目根目录的 .eslintrc.js 文件中，添加 globals 配置项，声明小程序全局方法：

javascript复制
module.exports = {
  // 其他已有配置...
  globals: {
    // 微信小程序核心全局对象/方法
    wx: true,
    App: true,
    Page: true,
    Component: true,
    getApp: true,
    getCurrentPages: true,
    Behavior: true,
    // 小程序内部全局变量
    global: true,
    __wxConfig: true
  }
}

二、配置说明

• wx: true：声明微信小程序核心 API 对象为全局变量
• App/Page/Component：声明小程序页面、组件、应用构造函数为全局变量
• getApp/getCurrentPages：声明小程序内置工具方法为全局变量
• true 表示该全局变量可被重写，适配小程序开发规范

三、ESLint 生效前提

1. VS Code

   • 必须安装官方插件：ESLint
   • 安装后重启编辑器，配置即可生效

2. 微信开发者工具

   • 同样需要安装内置 ESLint 插件
   • 开启「代码检查」功能，配置才能生效

四、注意事项

1. 配置完成后，若仍报错，可重启编辑器/开发者工具
2. 该配置仅解决全局变量未定义的 ESLint 报错
3. 项目新增小程序全局 API 时，可直接在 globals 中追加声明