如何在MacOS Visual Studio中用Sikuli4Net/SikuliSharp实现.NET Core应用UI自动化测试

基础适配结论 #

• 两款基于SikuliX的.NET封装库支持MacOS环境运行，核心逻辑依赖SikuliX官方Java运行时jar包，只要环境配置符合要求，完全可以在Visual Studio for Mac的.NET Core测试项目中正常调用，不存在平台适配的硬限制。
• 你遇到的“代码可编译但运行报错、终端内配置正常但IDE内跑不通”的问题，本质是Mac平台的通用环境配置坑，和.NET封装层的功能无关，不需要替换测试工具。

核心问题排查方向 #

• 终端环境变量对IDE不生效
  你在终端执行echo $SIKULI_HOME能返回正确路径，不代表Visual Studio for Mac能读到这个配置。macOS的GUI应用启动时是通过系统launchd进程拉取环境变量，不会加载你在.bashrc、.zshrc这类交互式终端配置文件里写的自定义环境变量，这就会导致SikuliSharp/4Net在IDE内启动测试时，根本读不到你设置的SIKULI_HOME路径，自然触发启动报错。
• JDK与SikuliX jar的版本不匹配
  你安装的JDK 8需要和对应版本的SikuliX runnable jar匹配：如果是直接下载的最新版SikuliX jar，已经不再适配JDK 8，最低要求JDK 11，这种情况下哪怕环境变量全配置正确，Java进程启动时也会直接抛版本不兼容错误。另外Mac上安装JDK后如果没有完成系统级的路径注册，GUI应用也会找不到java可执行文件的位置。
• 系统权限拦截导致进程启动失败
  SikuliX运行时需要屏幕截图、模拟键鼠输入的系统权限，第一次从IDE触发测试流程时如果误点了权限拒绝，后续哪怕环境配置全部正确，Java进程启动后也会因为拿不到权限直接退出报错，这类问题不会在终端的变量校验环节暴露。

可直接落地的修复步骤 #

• 绕开系统环境变量传递
  不要依赖全局系统配置，直接在测试程序的启动逻辑里给当前进程注入SIKULI_HOME变量，在程序入口的最前面加一段代码：
  Environment.SetEnvironmentVariable("SIKULI_HOME", "/你的/sikuli/jar/存放目录绝对路径", EnvironmentVariableTarget.Process);
  这种方式直接给当前测试进程传递所需变量，完全绕开Mac GUI应用读不到终端自定义环境变量的问题，是最稳定的配置方式。
• 先校验Java侧运行可用性
  打开终端进入你存放sikuli jar的目录，执行java -jar 对应的sikuli运行jar包名，确认能正常拉起SikuliX的操作界面。如果这一步就报错，就对应调整JDK版本和jar的匹配关系：JDK 8对应下载v2.0.5版本的SikuliX runnable jar，JDK 11及以上版本适配最新版jar包。
• 补全系统权限
  打开Mac系统设置的「隐私与安全性」面板，在「辅助功能」「屏幕录制」两个权限分类下，给Visual Studio、测试项目生成的可执行进程、Java运行程序全部勾选授权，排除权限拦截导致的启动异常。

内容的提问来源于stack exchange，提问作者adamasan