Windows 10/11 下用 Node.js 18 搞定 Wechaty 机器人部署（保姆级避坑指南）

1. 环境准备：从零搭建开发基础

在开始 Wechaty 机器人开发之前，确保你的 Windows 系统已经准备好以下基础环境。许多初学者往往在这一步就遇到各种问题，导致后续流程无法进行。

1.1 Node.js 18+ 的正确安装方式

Node.js 是 Wechaty 运行的基础环境，但很多教程没有说明版本兼容性问题。以下是经过验证的最佳实践：

1. 下载官方安装包：前往 Node.js 官网 下载 LTS 版本（当前推荐 18.x）
2. 安装选项注意：
   • 勾选 "Automatically install the necessary tools"（自动安装必要工具）
   • 确保 "Add to PATH" 选项被选中
3. 验证安装：

   bash复制node -v
   npm -v
   

   应该分别显示 v18.x.x 和 9.x.x 以上的版本号

注意：如果你之前安装过旧版本 Node.js，建议先完全卸载再安装新版，避免版本冲突。

1.2 项目目录设置技巧

很多初学者直接在桌面或文档文件夹创建项目，这可能导致权限问题。推荐以下做法：

bash复制# 在 PowerShell 或 CMD 中执行
mkdir D:\wechaty-project
cd D:\wechaty-project

为什么选择D盘？ Windows 系统盘（通常是C盘）有时会有严格的权限限制，特别是企业环境中。

2. Wechaty 核心安装与配置

2.1 初始化 Node.js 项目

在项目目录下执行：

bash复制npm init -y

这会生成默认的 package.json 文件。

2.2 安装 Wechaty 及其依赖

执行以下命令安装最新版 Wechaty：

bash复制npm install wechaty@latest

常见问题解决：

• 如果遇到 EPERM 错误，尝试以管理员身份运行终端
• 如果下载