Auto.js 入门指南（二）环境搭建前言大家好，我是鲫小鱼。是一名不写前端代码的前端工程师，热衷于分享非前端的知识，

前言

大家好，我是鲫小鱼。是一名不写前端代码的前端工程师，热衷于分享非前端的知识，带领切图仔逃离切图圈子，欢迎关注我，微信公众号：《鲫小鱼不正经》。欢迎点赞、收藏、关注，一键三连！！

第二章：环境搭建

一、理论讲解：Auto.js 环境搭建全流程

Auto.js 是一款基于 JavaScript 的 Android 自动化工具，支持无障碍服务、UI 控件识别、脚本录制等强大功能。要高效开发 Auto.js 脚本，首先需要搭建好开发环境。下面我们从零开始，带你一步步完成环境搭建。

1.1 Auto.js 版本选择

Auto.js 有多个版本，常见的有：

Auto.js 官方版：适合入门学习，功能较全，免费。
Auto.js Pro：付费版，支持更多高级特性（如无障碍服务、UI控件识别更强大）。
Auto.js 4.0/6.0/8.0：不同版本兼容性和功能略有差异，建议优先选择社区活跃、文档完善的版本。

建议：初学者可先用官方版或社区版，后续有需求再考虑 Pro 版。

1.2 开发环境准备

Android 设备：建议 Android 7.0 及以上，开启开发者模式和 USB 调试。
Auto.js App：官网下载或通过社区获取 APK 安装包。
PC 端辅助工具（可选）：如 VSCode、ADB 工具、Scrcpy 投屏等，提升开发效率。

1.3 目录结构最佳实践

建议参考如下目录结构，便于后续项目管理和协作：

autojs-project/
├── main.js                # 主入口脚本
├── config/                # 配置文件目录
├── libs/                  # 公共库/工具函数
├── modules/               # 功能模块
├── resources/             # 资源文件
├── logs/                  # 日志输出
├── README.md              # 项目说明文档
└── package.json           # 依赖与元信息（如有）

二、代码示例：环境搭建与第一个脚本

2.1 安装 Auto.js

前往 Auto.js 官方 GitHub 或 Auto.js Pro 官网下载 APK。
将 APK 拷贝到手机，安装并授权相关权限（无障碍、悬浮窗、存储等）。

2.2 连接设备与调试

步骤一：开启开发者选项和 USB 调试

手机设置 → 关于手机 → 连续点击"版本号"7次，解锁开发者选项。
返回设置 → 系统 → 开发者选项 → 打开"USB 调试"。

步骤二：PC 端安装 ADB 工具

Mac 用户可用 Homebrew 安装：
```
brew install android-platform-tools
```
Windows 用户可下载 ADB 工具包。

步骤三：连接手机

用数据线连接手机与电脑，终端输入：
```
adb devices
```
出现设备序列号即连接成功。

步骤四：投屏辅助（可选）

推荐 Scrcpy 实现手机画面投屏到电脑，便于调试和录制。

2.3 编写第一个 Auto.js 脚本

新建 main.js 文件，输入以下代码：

// main.js
toast("Hello, Auto.js!");

在 Auto.js App 中运行

打开 Auto.js，点击"新建脚本"，粘贴上述代码。
点击"运行"，手机屏幕弹出"Hello, Auto.js!"提示，说明环境搭建成功。

三、实战项目：自动打开微信并发送消息

3.1 需求分析

打开微信
自动搜索联系人"文件传输助手"
发送一条消息"Hello from Auto.js!"

3.2 代码实现

// modules/wechatSender.js
function sendWeChatMsg() {
  launchApp("微信");
  sleep(2000);
  if (id("com.tencent.mm:id/ft").exists()) {
    id("com.tencent.mm:id/ft").findOne().click(); // 点击搜索
    sleep(500);
    setText("文件传输助手");
    sleep(1000);
    text("文件传输助手").findOne().parent().click();
    sleep(1000);
    setText("Hello from Auto.js!");
    sleep(500);
    click("发送");
  } else {
    toast("未找到微信搜索框");
  }
}
sendWeChatMsg();

3.3 项目结构

autojs-project/
├── main.js
├── modules/
│   └── wechatSender.js

3.4 运行效果

自动打开微信，搜索并发送消息，全程无需手动操作。

四、常见问题与解决方案

问题	解决方案
安装 APK 时提示"未授权"	检查是否开启"允许安装未知来源应用"
ADB 连接不上设备	检查数据线、驱动、USB 调试是否开启
脚本运行无反应	检查无障碍服务、悬浮窗权限是否开启
控件找不到/点击无效	使用 UI Automator Viewer 辅助定位控件，或尝试 text/desc/id 多种方式
运行报错"找不到模块"	检查模块路径、文件名是否正确，建议使用相对路径

五、性能优化建议

模块化拆分：将不同功能拆分为独立模块，提升可维护性。
按需加载：只加载当前需要的模块，减少内存占用。
日志分级：开发阶段多输出日志，正式运行时关闭或降低日志等级。
异常捕获：所有关键操作加 try-catch，避免脚本崩溃。

最后感谢阅读！欢迎关注我，微信公众号：《鲫小鱼不正经》。欢迎点赞、收藏、关注，一键三连！！！