项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 10900
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Go 1.11 及以上(需支持 Go module)
- 支持 macOS、Windows、Linux 系统
- 支持 arm64 与 x86-amd64 架构
- Linux 需系统包管理器安装 Go(apt 或 snap)
- 编译依赖底层图形库,缺失时可能报 png.h 错误
安装与启动步骤
-
1安装 Go 环境
Linux 可用 apt 或 snap 安装 Go 工具链;其他平台先装好 Go,README 要求 1.11+ 以支持 module。
sudo apt install golang -
2初始化 Go 模块
在项目目录下初始化 module,这样才能用 go get 拉取 robotgo 并 import 该包。
go mod init robotgo-demo -
3拉取 robotgo 依赖
执行 go get 下载安装 robotgo 包,等待依赖写入 go.mod 与 go.sum。
go get github.com/go-vgo/robotgo -
4在代码中导入包
Go 1.11+ 支持 module 时,直接在源码中 import 该包即可使用其 API。
import "github.com/go-vgo/robotgo" -
5构建或运行程序
macOS arm64 可按 README 关闭 CGo 用 purego 构建;其他平台直接 go run 编译运行。
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -tags mac .
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
CGO_ENABLED | 否 | 设为 0 表示关闭 CGo,macOS 走 purego 运行时加载 | 0 |
GOOS | 否 | 指定目标操作系统,README 示例为 darwin | darwin |
GOARCH | 否 | 指定目标架构,README 示例为 arm64 | arm64 |
如何确认成功
go get 无报错,go build 或 go run 编译通过、无 png.h 等缺失库错误,即表示安装成功。
常见问题
Q:编译报 png.h: No such file or directory 怎么办?
A:说明系统缺少图形相关开发库,README 指向 issues/47,请按该 issue 安装缺失依赖后重新编译。
Q:robotgo 支持哪些平台和架构?
A:支持 Mac、Windows、Linux,并且支持 arm64 与 x86-amd64 架构。
Q:必须安装 Xcode 吗?
A:不必。macOS 下 Quartz/CoreGraphics 通过 purego 在运行时加载,README 明确说明无需 Xcode。
Q:Go 版本有什么要求?
A:需要 Go 1.11 及以上版本,以便使用 Go module 支持并直接 import 该包。
注意事项
- 非 module 模式的老项目改用 go get github.com/go-vgo/robotgo 安装。
- macOS arm64 可用 CGO_ENABLED=0 加 -tags mac 构建,无需 Xcode。
- Linux 上可用 sudo apt install golang 或 sudo snap install go --classic 安装 Go。
- 需要 CGo 与系统底层图形库配合,编译环境不完整时优先查官方 issue。
核心亮点
- 跨平台统一 API,一套代码搞定 Windows/macOS/Linux 桌面自动化
- 内置 OpenCV 图像识别,支持视觉定位元素,适合复杂 UI 操作
- 提供全局鼠标键盘钩子,可监听系统事件,扩展性强
不足之处
- CGo 依赖导致交叉编译和部署较麻烦
- 文档示例偏少,高级功能需读源码
适用场景
- 编写跨平台桌面自动化测试脚本
- 实现 RPA 流程,如自动填表、文件处理
- 构建基于视觉的 AI 助手,模拟人工操作
替代项目
SikuliX、PyAutoGUI、AutoHotkey
上一篇:robotframework
下一篇:TagUI
同类项目推荐
open-flow
开源
画布拖拽加真 TypeScript,自托管跑通自动化流程
Build workflows you can see, code, run, and own. Open-source visual workflow automat···
AIHawk
开源
让 AI 替你上网干活,从批量投简历到任意网页操作
Playwright MCP server undetected by anti-bots and captchas: AI agent browses the web···
blender-mcp
开源
用聊天让 LLM 直接操控 Blender 建模
Community plugin to control Blender 3D with any LLM of your choice. Not affiliated w···
n8n-workflow-builder
开源
用自然语言对话,让 AI 帮你自动搭建 n8n 工作流
AI assistant integration for n8n workflow automation through Model Context Protocol ···
chengos
开源
可视化搭 AI 工作流,多模型 Agent 一键部署落地
ChengOS is a visual AI data processing and agent workflow system. This directory con···
robotframework
开源
用表格写自动化,测试和 RPA 一把抓
Generic automation framework for acceptance testing and RPA
kdriver
开源
Kotlin 协程直连 CDP,快速抓取且不易被识别
A blazing fast, coroutine-first, undetectable web scraping / browser automation CDP-···
autogram
开源
自动抓AI新闻,生成图片发Instagram
AI agent that automates AI news curation and post to Instagram using gpt-image-1
workflow-builder-template
开源
拖拽连线搭 AI 工作流,快速做出自动化原型
Visual AI workflow automation platform
