Manus v1.9安装失败因旧版残留导致版本冲突,需彻底清除/Applications/Manus.app、LaunchServices注册、签名缓存及配置目录,再通过Homebrew或手动安装v26.11.4并运行manus check-env验证环境。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Manus v1.9 安装失败且提示“版本冲突”,不是单纯下载错包,而是系统中残留旧版二进制、签名缓存或Homebrew公式未同步导致的硬性校验失败——此时即使手动替换.app文件或重下dmg,也会在启动时被macOS Gatekeeper拦截或触发内部版本号校验断言。
确认真实冲突来源
打开终端,执行:
manus --version 2>/dev/null || echo "未安装" && brew info manus 2>/dev/null | head -n 3
若输出显示旧版(如 v1.8.3)或提示 “Not installed”,但双击 dmg 安装后仍报错,则说明冲突来自系统级签名缓存或LaunchServices注册表残留,而非文件覆盖问题。
【关键前提】不要直接覆盖 /Applications/Manus.app —— macOS会拒绝运行签名不匹配的同名应用,且不会提示具体原因。
彻底清除旧版残留
第一步:卸载当前可见的Manus应用
将 /Applications/Manus.app 拖入废纸篓 → 右键「清空废纸篓」。
第二步:清除系统级注册信息
在终端中执行:
lsregister -u /Applications/Manus.app 2>/dev/null || true
此命令强制注销LaunchServices中所有与Manus相关的App ID绑定,避免新安装包因Bundle ID冲突被拒。
这款全能AI助手融合了深度推理、多模态对话与图像生成等前沿技术,全面赋能职场、学习与生活。它支持多模态搜索,精准响应各类信息需求;内置AI文档助手,快速提炼要点并生成思维导图;更有智能创作功能,一键生成报告与文案。强大的AI能力助你高效处理复杂任务,让工作与生活更轻松便捷。
第三步:删除签名缓存与配置目录
执行:
rm -rf ~/Library/Caches/ai.manus.*
rm -rf ~/Library/Application\ Support/Manus
rm -rf ~/Library/Preferences/ai.manus.*
rm -f ~/Library/LaunchAgents/ai.manus.*
⚠️ 注意:这一步不可跳过。v1.9 启动时会读取 ~/Library/Preferences/ai.manus.plist 中的 license_state 和 last_version 字段,若该文件存在且版本号低于1.9,会主动拒绝加载新二进制。
安装最新版v26.11.4的正确路径
方法一:通过Homebrew安装(推荐,自动处理依赖与签名)
brew tap homebrew/cask-versions
brew install --cask manus
方法二:手动安装(仅限需绕过App Store审核场景)
从Manus官网下载 v26.11.4 dmg → 挂载后,按住 Control 键双击Manus.app → 选择「打开」→ 系统弹出“已损坏”警告时,点击「仍要打开」→ 此操作将临时豁免Gatekeeper对未公证二进制的拦截。
方法三:终端强制信任签名(适用于M系列芯片Mac)
xattr -rd com.apple.quarantine /Applications/Manus.app
codesign --force --deep --sign - /Applications/Manus.app
【必须执行】安装完成后立即在终端运行 manus check-env,确认输出中 local_file: ✅、quartz: ✅、version: v26.11.4 全部为绿色对勾,否则后续功能将部分失效。

















