uni-app Hbuilderx(4.08) 新建项目出现 `wx is not defined` 错误

在 uni-app 中使用 HbuilderX（版本 4.08）新建项目时，如果出现 wx is not defined 错误，通常是因为在项目中使用了微信小程序的 API，但当前环境并不是微信小程序，或者没有正确配置微信小程序的运行环境。以下是一些可能的解决方案：

1. 检查运行环境

确保你当前运行的环境是微信小程序。在 HbuilderX 中，你可以在工具栏的左侧选择运行环境。点击 运行 -> 运行到小程序模拟器 -> 微信开发者工具，确保项目在微信开发者工具中运行。

2. 检查代码中是否误用了 wx 对象

在 uni-app 中，wx 是微信小程序的全局对象。如果你在非微信小程序环境中（如 H5 或 App）使用了 wx，就会报错 wx is not defined。建议使用 uni-app 的跨平台 API，例如：

• 替换 wx.request 为 uni.request
• 替换 wx.showToast 为 uni.showToast

示例：

// 错误：在非微信小程序环境中使用 wx
wx.request({
  url: 'https://example.com',
  success(res) {
    console.log(res);
  }
});

// 正确：使用 uni-app 的跨平台 API
uni.request({
  url: 'https://example.com',
  success(res) {
    console.log(res);
  }
});

3. 条件编译

如果你需要在不同平台使用不同的代码，可以使用 uni-app 的条件编译功能。例如，只有在微信小程序环境中才使用 wx：

// #ifdef MP-WEIXIN
wx.request({
  url: 'https://example.com',
  success(res) {
    console.log(res);
  }
});
// #endif

4. 检查项目配置

确保项目的 manifest.json 文件中正确配置了微信小程序的相关设置。例如：

{
  "mp-weixin": {
    "appid": "你的微信小程序AppID",
    "setting": {
      "urlCheck": false,
      "es6": true,
      "postcss": true,
      "minified": true
    }
  }
}

5. 更新 HbuilderX 和 uni-app

确保你使用的 HbuilderX 和 uni-app 是最新版本。老版本可能存在一些兼容性问题。你可以通过以下步骤更新：

• 打开 HbuilderX，点击 帮助 -> 检查更新。

• 如果 uni-app 版本较旧，可以在项目根目录运行以下命令更新：

  npm install [@dcloudio](/user/dcloudio)/uni-app -g
  

6. 清除缓存并重新运行

有时缓存可能导致问题，可以尝试清除 HbuilderX 的缓存并重新运行项目：

• 点击 运行 -> 清除缓存。
• 重新编译并运行项目。

7. 检查微信开发者工具

如果是在微信开发者工具中运行，确保微信开发者工具的版本是最新的，并且正确配置了项目路径和 AppID。

8. 调试和日志

如果问题仍然存在，可以在代码中添加调试信息，检查当前运行平台：

console.log(uni.getSystemInfoSync().platform);