按 Windows、macOS、Linux 拆开安装步骤,讲清 System/User 权限差异、VS Code 配置该怎么导、索引等待与六种「装完打不开」的排查顺序。
三分钟确认,能省掉后面半小时的排查。
本篇 cursor安装 按平台拆开步骤。开始前先确认:系统版本在支持范围内、架构与安装包一致、磁盘有足够空间、以及你能不能获得管理员权限(决定 Windows 选 System 还是 User)。
| 检查项 | Windows | macOS / Linux |
|---|---|---|
| 系统版本 | Windows 11 / 10 | macOS 建议 12+;Linux 需较新 glibc 与图形栈 |
| 架构 | x64 或 ARM64 | Apple Silicon / Intel / x86-64 / aarch64 |
| 权限 | System 需提权,User 免提权 | dmg 拖入应用目录;Linux 包安装需 sudo |
| 账号 | 准备可登录的账号 | 订阅与模型额度与账号绑定 |
| 网络 | 能访问官方域名 | 首次登录与索引可能需联网 |
最需要注意的是 System 与 User 的选择。
在 下载页 按 x64 / ARM64 选 System 或 User 的 exe。公司受管设备没有管理员权限就选 User。
System 会弹 UAC 并写入 Program Files;User 直接写进用户目录,不会请求提权。两者功能一致。
按提示登录账号;若系统时间偏差较大,先校准时间,否则证书校验与登录都可能失败。
打开项目后等索引状态结束再下任务,大仓库第一次会明显慢一些。
一个走 dmg,一个按发行版选包格式。
下载 Apple Silicon(ARM64)或 Intel(x64)dmg,也可选 Universal;拖入「应用程序」后首次打开若被拦截,到「系统设置 → 隐私与安全性」点「仍要打开」。
Debian/Ubuntu 系用 deb、Fedora/RHEL 系用 rpm,用系统包管理器安装,便于后续升级与卸载。
下载后执行 chmod +x 再运行,不写系统目录,是最接近免安装的官方形态。
无桌面环境的服务器不适合装桌面版,官方另有 CLI 形态;功能与桌面版不完全等价,选型前先看 平台与要求。
建议导入一部分,而不是整个搬家。
| 配置类型 | 建议 | 原因 |
|---|---|---|
| 快捷键 | 导入 | 肌肉记忆最值钱,导入后适应成本最低 |
| 主题 / 字体 | 导入 | 纯显示层,无冲突风险 |
| 常用插件 | 按需重装 | 部分插件与新版不兼容,AI 相关能力由本工具自身提供 |
| AI 类插件 | 不建议 | 功能重叠,可能互相抢占补全与快捷键 |
| 旧的工作区设置 | 逐项检查 | 可能覆盖新版本的默认行为 |
导入后先打开一个小项目试跑一轮,确认补全、终端、Git 集成都正常,再把大仓库搬过来。
从上往下走,别一上来就重装。
Windows 看任务管理器、macOS 用「强制退出」,关窗口不等于退进程。
在「关于」里看版本;ARM64 设备误装 x64 包会出现性能异常。
看数字签名 / Gatekeeper 公证,见 校验签名。
时间偏差会让证书校验与登录失败。
插件冲突是启动白屏与卡顿的高频原因。
先备份用户配置目录,再卸载重装,最后逐项导回。
如果六步都无效,带上版本、系统、架构与错误截图到 支持与反馈 里按模板提问。
把下一步路径一次给全。
至此 cursor安装 完成。若需要固定版本做回归,再看 历史版本;升级前先读 更新日志。建议把 cursor安装 的四步流程写进团队环境文档,cursor安装 的排查顺序也一并附上,新同事照着做即可。