GeminiDesktop GeminiDesktop
教程指南

Gemini for Mac 安装排错:Gatekeeper、Accessibility 权限和常见问题

发布于 · 作者: GeminiDesktop Team

Gemini for Mac 通过 DMG 分发,不走 Mac App Store,macOS 安全机制会拦截。本文汇总所有常见安装问题和修复方法,从 Gatekeeper 警告到辅助功能权限再到网络排查都配上具体命令。

TL;DR 快速参考

故障 关键命令
Gatekeeper 警告 系统设置 > 隐私与安全性 > 仍然打开
“已损坏”错误 xattr -cr /Applications/Gemini.app
辅助功能不生效 tccutil reset Accessibility com.google.Gemini
查芯片是否 Apple Silicon sysctl -n machdep.cpu.brand_string
查 macOS 版本 sw_vers -productVersion(需 15+)
完全卸载 删除 /Applications/Gemini.app + ~/Library/Application Support/Gemini + ~/Library/Preferences/com.google.Gemini.plist + ~/Library/Caches/com.google.Gemini
看崩溃日志 /Applications/实用工具/控制台.app 搜 Gemini
验证开发者签名 codesign --verify --verbose /Applications/Gemini.app

Windows 用户提示:本文所有步骤仅针对 macOS。Google 没有原生 Gemini Windows 应用,Windows 端请参考 原生 Gemini Windows 应用替代方案Gemini Windows 安装指南为什么 Google 没做 Gemini Windows 应用

安装前:确认机器符合要求

装之前花 30 秒检查以下三个硬性条件,能省掉 90% 的后续排错:

# 1) 芯片:应当包含 Apple M1/M2/M3/M4 字样
sysctl -n machdep.cpu.brand_string

# 2) macOS 版本:应当 >= 15.0
sw_vers -productVersion

# 3) 磁盘空间:建议 Applications 所在卷 >= 2GB
df -h /

如果第 1 项输出带有 Intel,Gemini 官方版完全不工作,直接去Intel Mac 替代方案;如果第 2 项低于 15,在 系统设置 > 通用 > 软件更新 里先升级 macOS。

“无法打开 Gemini,因为 Apple 无法检查其是否包含恶意软件”

这是最常见的问题。Gatekeeper 默认拦截非 App Store 应用。

修复步骤:

  1. 关闭弹窗
  2. 打开 系统设置 > 隐私与安全性
  3. 在安全性区域找到 Gemini 被拦截的提示
  4. 点击 仍然打开,输入密码确认
  5. 再次启动 Gemini,点击 打开

此后不再拦截。

为什么会出现这个警告

Gemini for Mac 是用开发者 ID 签名但不走 Mac App Store 审核的应用。macOS 从 Catalina 开始对这类应用做“公证检查(notarization check)”。公证要求开发者把构建产物上传 Apple 扫描病毒和签名规则。正常情况下 Apple 的 notary 服务返回放行票据,启动时 Gatekeeper 在线验证票据,不会弹窗。

弹这个警告通常是三种情况:

  1. 本地 notarization ticket 不在:DMG 下载来源被剥掉了扩展属性;
  2. 离线状态下第一次启动:无法联网验证票据;
  3. Google 最新版本的票据还在缓存生效中:等几分钟 Apple 后端同步后再试。

解决方式就是在「隐私与安全性」里主动放行一次,macOS 会把该版本加入本机白名单。

“Gemini 已损坏,无法打开”

通常不是真的损坏,而是 macOS 隔离属性导致。在终端运行:

xattr -cr /Applications/Gemini.app

如果仍然报错,删除应用后重新下载,安装前先对 DMG 文件执行:

xattr -cr ~/Downloads/Gemini*.dmg

企业 Mac 可能受 MDM 策略限制,需联系 IT 部门。

看扩展属性到底是什么

# 查看 app bundle 上挂的扩展属性
xattr -l /Applications/Gemini.app

# 最常见的是 com.apple.quarantine
# 0081;xxxxxxxx;Chrome;ABC-123

com.apple.quarantine 是从浏览器、邮件、AirDrop 等来源下载时 macOS 自动打上的“来源未知”标记。xattr -cr 会递归清除 app bundle 内所有子文件的这个属性。大多数“已损坏”报错根源都在这里。

签名和公证验证

出现“已损坏”时可以用下面命令确认签名完整性:

# 检查 bundle 签名
codesign --verify --deep --verbose=2 /Applications/Gemini.app

# 检查公证状态
spctl --assess --type execute -v /Applications/Gemini.app

签名正常的输出是 Gemini.app: accepted source=Notarized Developer ID。如果输出 rejected 且不是由 MDM 策略导致,建议重新去 gemini.google/mac 下载全新 DMG,国内镜像站可能分发的不是最新官方签名版本。

Accessibility 权限未生效

全局快捷键 Option+Space 需要辅助功能权限。如果没有弹出权限请求:

  1. 打开 系统设置 > 隐私与安全性 > 辅助功能
  2. 点击 + 添加 Gemini
  3. 确保开关已开启
  4. 完全退出(Cmd+Q)后重启应用

如果已添加但快捷键不生效,先关闭再移除 Gemini,重启后重新添加。也可用终端重置:

tccutil reset Accessibility com.google.Gemini

还需要哪些权限

权限 何时需要 设置路径
辅助功能 全局快捷键 隐私与安全性 > 辅助功能
屏幕录制 屏幕共享 隐私与安全性 > 屏幕录制
麦克风 语音输入 隐私与安全性 > 麦克风
相机 拍照作为输入 隐私与安全性 > 相机
完全磁盘访问 读取个人文档库 隐私与安全性 > 完全磁盘访问(按需)

macOS 版本不满足要求

Gemini for Mac 要求 macOS 15 Sequoia。macOS 14 或更低版本无法安装。打开 系统设置 > 通用 > 软件更新 检查是否可升级。

如果你的机器不支持升级到 macOS 15(早于 2018 年的 Mac 绝大部分不支持),也只能走替代方案。不要去装那些声称“能把 Gemini 跑在 Ventura”的破解版 DMG,非官方签名包有潜在安全风险。

不支持 Intel Mac

Gemini for Mac 仅支持 Apple Silicon(M1/M2/M3/M4)。在 Apple 菜单 > 关于本机 查看芯片类型。Intel Mac 用户的替代方案:

  • GeminiDesktop.app – 支持 Intel Mac,Mac App Store 分发
  • Claude Desktop / ChatGPT Desktop – 均支持 Intel Mac
  • gemini.google.com – 浏览器访问,不限机型

背景阅读:Gemini for Mac 仅限 Apple Silicon:Intel 用户怎么办

打开后立即闪退

打开 控制台.app 搜索 Gemini 查看崩溃日志。常见原因和修复:

  • 内存不足:关闭其他应用
  • 偏好设置损坏:删除 ~/Library/Preferences/com.google.Gemini.plist~/Library/Application Support/Gemini
  • 安全软件冲突:临时禁用杀毒软件

崩溃日志看什么

从控制台左侧选择 崩溃报告,最近的 Gemini crash 打开后关注三行:

  1. Termination Reason: —— 是系统杀的还是主动 abort
  2. Exception Type: —— EXC_BAD_ACCESS 多是签名或库不匹配,EXC_CRASH (SIGABRT) 多是配置损坏
  3. 调用栈最顶几行是否来自 Gemini 自身,还是来自系统框架

如果调用栈里出现大量 KaspersyBlockingUSBRelayDriver 之类第三方内核扩展,多半是杀毒软件拦截,先禁用再试。

完全重装

rm -rf ~/Library/Caches/com.google.Gemini
rm -rf ~/Library/Application\ Support/Gemini
rm -rf ~/Library/Preferences/com.google.Gemini.plist

删除应用后重新从 gemini.google/mac 下载安装。

补充要清理的常见残留(按需):

# 登录项(如果曾开机自启)
osascript -e 'tell application "System Events" to delete login item "Gemini"'

# TCC 权限记录(辅助功能 / 屏幕录制 / 麦克风)
tccutil reset Accessibility com.google.Gemini
tccutil reset ScreenCapture com.google.Gemini
tccutil reset Microphone com.google.Gemini

# 代码签名缓存
dscacheutil -flushcache

常见问题快速排查表

症状 可能原因 首选处理
登录后一直白屏 登录重定向被代理拦截 关 VPN,或把 accounts.google.com 加代理白名单
回复只显示「•••」然后消失 网络丢包或账号被限流 切 Flash 模型,或稍后重试
上传 PDF 报「文件过大」 Gemini for Mac 额度用完 换到 Advanced 订阅或把 PDF 拆分
屏幕共享黑屏 屏幕录制权限未开 见上面权限表
菜单栏文字变英文 UI 语言未跟随系统 设置 > 通用 > 语言,手动选中文
首选项面板空白 偏好 plist 损坏 走上面完全重装流程
无法登录 Workspace 账号 管理员禁用了 Gemini 联系 IT,让管理员在控制台开启
每次开机都弹“开发者已验证” 公证票据缓存异常 给 DMG 和 app 都跑 xattr -cr

网络异常与登录问题

Gemini for Mac 通过以下几个主要域名与 Google 后端通信,任一被阻断都会导致登录或回复失败:

域名 用途 阻断症状
accounts.google.com 登录 一直卡在登录白屏
gemini.google.com 会话路由 登录成功但对话进不去
generativelanguage.googleapis.com 模型推理后端 发消息转圈、一直“思考中”
lh3.googleusercontent.com 用户头像 / 图像生成结果 头像空白、图片无法显示
www.google.com Deep Research / 搜索接地 搜索结果为空

国内用户若发现登录成功但无法发消息,优先检查代理/VPN 是否对 generativelanguage.googleapis.com 放行;企业代理环境下也要把这几个域名报给网络管理员加白。

判断是不是 DNS 问题

# 看看是否能解析
dig gemini.google.com +short
dig generativelanguage.googleapis.com +short

# 绕开系统 DNS,用 Google 公共 DNS 解析
dig @8.8.8.8 generativelanguage.googleapis.com +short

解析不到或解析到异常 IP,说明 DNS 链路被污染,可切到 1.1.1.1 或 8.8.8.8 验证。

企业场景特殊处理

MDM 管理的 Mac 上,很多策略会阻止用户自行装 DMG:

  • Jamf / Kandji / Intune:请 IT 同学把 com.google.Gemini 加入允许的 bundle ID 列表,并下发一份 PPPC(Privacy Preferences Policy Control)配置,一次性授权辅助功能和屏幕录制,省掉逐台点击。
  • DLP 策略:部分企业会拦截向 Gemini 后端域名的请求,请提前和安全同事确认 generativelanguage.googleapis.com 是否放行。
  • 账号类型:普通 Gmail 账号和 Workspace 账号走的后端不同,免费额度与合规承诺也不同。Workspace 用户若出现“没有权限使用 Gemini”,一定是管理员侧未开启。

FAQ

Q1. 能否在 macOS 14 上强装 Gemini for Mac? A. 不能。官方 DMG 的 LSMinimumSystemVersion 设为 15.0,双击会被系统直接拒绝启动。升级系统或用替代方案。

Q2. 装完之后磁盘空间明显减少,正常吗? A. 首次运行会下载一部分本地资源和索引缓存,通常占 300-800MB。如果超过 5GB,很可能是你上传过大量文件导致临时目录膨胀,清理 ~/Library/Caches/com.google.Gemini 即可。

Q3. “仍然打开”按钮灰色不能点? A. 可能是公司 MDM 关闭了用户覆盖权限的能力。需要 IT 下发允许名单,或者改用 Mac App Store 分发的替代方案。

Q4. 为何 xattr -cr 之后仍然提示已损坏? A. 少数情况下 DMG 本身下载不完整。删除 DMG 重新从官网下载,或者走 Homebrew Cask,Cask 会校验下载完整性。

Q5. 卸载完能否清理 Google 账号的云端数据? A. 可以,但不能通过本地卸载完成。去 myactivity.google.com,筛选 Gemini 的活动记录手动删除;同时在 Gemini 设置 > 数据控制里关闭“活动记录”。

Q6. 如何把权限一次性给全,避免后续弹窗? A. 在 系统设置 > 隐私与安全性 里依次为 Gemini 勾选:辅助功能、屏幕录制、麦克风、相机。不需要的可以不勾,例如不打算用屏幕共享就别给屏幕录制。

Q7. 能否保留多个版本并行? A. 不行。macOS 以 bundle ID 识别应用,com.google.Gemini 只能存在一个。想尝鲜 Beta 版,退出主 Gemini 再运行 Beta。

Q8. 装完后发现被 Spotlight 收录搜索到 “Gemini” 会调起别的应用,怎么办? A. 在 系统设置 > Siri 与 Spotlight > 搜索结果 里取消勾选无关应用;也可以直接重建索引:sudo mdutil -E /。重建之后 Spotlight 只会匹配 /Applications/Gemini.app,不会再跳到 Chrome 的 Gemini 书签或第三方工具。重建期间系统会占用磁盘 I/O,约几分钟到半小时,期间耐心等待即可。

避免这些问题的替代方案

上述问题大多源于 DMG 分发方式。GeminiDesktop.app 通过 Mac App Store 分发,Gatekeeper、签名、沙盒、自动更新全部由 Apple 处理,支持 Intel 和 Apple Silicon,macOS 13+ 即可使用。

延伸阅读

Mac App Store 免费下载: GeminiDesktop.app