VSCode 远程开发 — 在电脑上编写手机脚本
为什么要远程开发
AutoJs6 虽然内置了完整的 IDE,但在手机上写代码毕竟不如在电脑上舒服:
| 对比项 | 手机 IDE | VSCode 远程开发 |
|---|---|---|
| 输入体验 | 软键盘 | 物理键盘 |
| 屏幕大小 | 手机屏幕 | 显示器 |
| 快捷键 | 有限 | 完整 |
| 文件管理 | 触屏操作 | 文件树 |
| 调试 | 有限 | 断点调试 |
| Git 集成 | 无 | 完整 |
| 扩展生态 | 无 | 数千个 VSCode 扩展 |
安装 VSCode 插件
AutoJs6 VSCode Extension
插件 ID:003.autojs6-vscode-ext
安装方法:
- 打开 VSCode
Ctrl + Shift + X打开扩展市场- 搜索 "AutoJs6"
- 找到 "AutoJs6 VSCode Extension" → 安装
- 重启 VSCode
或命令行安装:
code --install-extension 003.autojs6-vscode-ext
连接方式
AutoJs6 VSCode Extension 支持两种连接模式:
模式一:LAN(局域网)
通过 Wi-Fi 连接,适合手机和电脑在同一网络下。
步骤:
- 确保手机和电脑在同一 Wi-Fi 网络
- 手机上打开 AutoJs6 → 设置 → VSCode 连接 → 开启服务
- 记录手机显示的 IP 地址(如
192.168.1.100) - VSCode 中按
Ctrl + Shift + P打开命令面板 - 输入并选择
AutoJs6: 建立设备连接 (Connect) - 选择客户端模式 → 输入手机 IP 和端口(默认 62001)
- 连接成功
模式二:ADB(USB / 无线调试)
通过 ADB 连接,更稳定,适合开发调试。
前置条件:
- 电脑安装了 Android SDK Platform Tools(含 adb)
- 手机开启了开发者选项和 USB 调试
步骤:
- USB 连接手机和电脑
- 手机上授权 ADB 调试
- VSCode 中打开命令面板 →
AutoJs6: 建立设备连接 (Connect) - 选择 ADB 模式
- 连接成功
模式选择建议
| 模式 | 优点 | 缺点 | 推荐场景 |
|---|---|---|---|
| LAN | 无需 USB 线,灵活 | 网络不稳定时断连 | 日常编写、轻量调试 |
| ADB | 稳定可靠、速度快 | 需要 USB / ADB 设置 | 调试、发布前验证 |
远程开发流程
在 VSCode 中打开 AutoJs6 文件
连接成功后,可以直接浏览和编辑手机上的 AutoJs6 脚本:
- VSCode 资源管理器会显示已连接的设备
- 可以浏览手机上 AutoJs6 的脚本目录
- 打开 .js 文件 → 正常编辑(有代码补全)
- 保存后文件自动同步到手机
远程运行脚本
方法一:
在 VSCode 中打开脚本 → 右键 → Run on Device
或按 F5(需要配置 launch.json)
方法二:
Ctrl + Shift + P → AutoJs6: Run Script
脚本会在手机上执行,控制台输出同步回 VSCode。
断点调试(高级)
// .vscode/launch.json 配置
{
"version": "0.2.0",
"configurations": [
{
"type": "autojs6",
"request": "launch",
"name": "Run AutoJs6 Script",
"script": "${file}"
}
]
}
配置好后可以:
- 在代码行号旁边点击设置断点
- 按 F5 启动调试
- 脚本在断点处暂停
- 在 VSCode 的调试面板中查看变量值、调用栈
常见问题
连接失败
LAN 模式:
- 确认手机和电脑在同一网段
- 确认手机防火墙没有阻止 AutoJs6 的端口
- 尝试 ping 手机 IP 看是否能通
- AutoJs6 设置中检查 VSCode 连接服务是否开启
ADB 模式:
- 执行
adb devices看设备是否已连接 - 如果设备列表为空,检查 USB 连接和调试授权
- 如果显示 "unauthorized",在手机上确认授权弹窗
脚本运行后无输出
- 检查脚本是否有语法错误
- 在 AutoJs6 应用内手动运行同一脚本,看是否正常
- 确认设备连接状态正常(VSCode 底部状态栏显示设备名)
中文乱码
确保 VSCode 打开文件时使用 UTF-8 编码:
- VSCode 右下角状态栏 → 编码 → Reopen with Encoding → UTF-8
插件版本与兼容性
| AutoJs6 版本 | 推荐插件版本 | 说明 |
|---|---|---|
| v6.7 | 最新版 | 完全兼容 |
| v6.6 | 最新版 | 基本兼容 |
| v6.5 及以下 | 可能不兼容 | 建议升级 AutoJs6 |
实战:完整远程开发工作流
1. 打开 VSCode,连接手机(ADB 模式)
2. 在资源管理器中浏览手机 AutoJs6 目录
3. 打开 scripts/myScript.js(有现成的脚本)
4. 需要修改 → 添加一个新的选择器定位逻辑
5. 保存(Ctrl + S)
6. 按 F5 远程运行
7. 在 VSCode 调试面板打断点
8. 手机自动执行脚本,在断点处暂停
9. 在 VSCode 中检查变量值、调用栈
10. 继续执行或单步调试
11. 调试完直接在 VSCode 中提交 Git(如果项目用 Git 管理)