成功安装Cursor需先确认系统版本≥Win10 19041或macOS 12.0，安装VC++运行库或启用未知开发者权限；再官网下载校验哈希的安装包；Windows以管理员运行并配置PATH，macOS拖入应用程序文件夹并授权；最后GitHub登录并配置AI模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 Windows 或 macOS 系统上成功安装 Cursor AI 编程编辑器，但遇到环境依赖缺失、安装包无法运行或权限拒绝等问题，则可能是由于系统配置未满足最低要求或安装路径存在特殊字符。以下是完成安装的全流程操作步骤：
一、确认系统兼容性与前置条件
Cursor 要求 Windows 10 19041+ 或 macOS 12.0+，且需确保系统已安装最新版 Visual C++ 运行库（Windows）或已启用“允许从未知开发者下载”的安全性设置（macOS）。未满足任一条件将导致安装程序启动失败或主进程崩溃。
1、在 Windows 上：按下 Win + R，输入 winver 并回车，确认版本号 ≥ 19041。
2、在 macOS 上：点击左上角苹果图标 → “关于本机”，核对系统版本是否 ≥ 12.0（Monterey）。
3、Windows 用户前往微软官网下载并安装 Visual C++ 2015–2022 Redistributable (x64)；macOS 用户打开“系统设置” → “隐私与安全性” → 滚动到底部，点击 “仍要打开”（针对首次运行 Cursor 安装包时出现的警告）。
二、下载官方安装包
必须使用 Cursor 官网提供的原始安装文件，第三方镜像或修改版可能嵌入恶意签名或禁用 AI 功能。安装包哈希值需与官网公示一致，否则应中止安装流程。
1、使用 Chrome 或 Edge 浏览器访问 https://cursor.sh，页面自动识别系统并显示对应下载按钮。
2、Windows 用户点击 “Download for Windows”，保存为 cursor-setup.exe；macOS 用户点击 “Download for Mac”，保存为 Cursor-Setup.dmg。
3、下载完成后，在文件资源管理器（Windows）或访达（macOS）中右键该文件 → “属性”（Windows）或“显示简介”（macOS），比对 SHA256 值是否与官网底部“Verification”栏一致。
三、Windows 系统安装步骤
Windows 安装采用 NSIS 打包器，需以管理员权限执行以写入注册表项及全局快捷方式。普通用户权限会导致快捷方式缺失或更新功能失效。
1、双击 cursor-setup.exe，弹出用户账户控制（UAC）提示时点击 “是”。
2、在安装向导界面，勾选 “Add to PATH (requires shell restart)” 选项，确保终端可直接调用 cursor 命令。
赋予Agent实时语音交互能力。与Claude对话！超快TTS文字转语音，约90毫秒低延迟音频输出。
3、点击 “Install”，等待进度条完成；安装结束后取消勾选 “Launch Cursor”，先完成下一步权限配置。
4、按 Win + X → 选择 “终端（管理员）”，输入 refreshenv 并回车，使 PATH 生效。
四、macOS 系统安装步骤
macOS 安装需绕过 Gatekeeper 对未公证应用的拦截机制，且必须将 Cursor.app 拖入“应用程序”文件夹而非桌面或文档目录，否则沙盒策略将阻止其访问本地项目文件。
1、双击打开 Cursor-Setup.dmg，窗口内会出现 Cursor.app 图标和“应用程序”文件夹图标。
2、按住 Cursor.app 图标，将其拖拽至右侧 “应用程序” 文件夹图标上，松手完成复制。
3、打开“访达” → 左侧边栏点击 “应用程序”，找到 Cursor.app，右键 → “显示简介”，勾选 “锁定” 防止被误删。
4、首次启动时若弹出“已损坏”提示，前往“系统设置” → “隐私与安全性” → 在“安全性”区域点击 “仍要打开”。
五、首次启动与基础配置
首次启动会触发本地模型初始化及 GitHub 登录绑定，网络请求必须直连 cursor.sh 域名，DNS 污染或代理转发异常将卡在“Loading models…”界面超过 90 秒。
1、Windows：在开始菜单搜索 “Cursor” 并点击启动；macOS：打开“应用程序”文件夹，双击 Cursor.app。
2、启动后出现登录弹窗，点击 “Continue with GitHub”，跳转浏览器完成 OAuth 授权，返回 Cursor 即可同步账户设置。
3、进入主界面后，按下 Ctrl + Shift + P（Windows）或 Cmd + Shift + P（macOS），输入 “Settings: Open Settings (JSON)”，在右侧 JSON 中添加："cursor.experimental.aiModel": "claude-3-haiku"。
