用途
Cursor Upgrade & Migration 用于升级 Cursor 版本、从 VS Code 迁移配置,以及在不同机器之间转移设置。它通过分阶段、可回滚的发布流程,保留策略、扩展、规则、工作区信任和用户恢复能力。
主要能力
- 版本升级:支持自动更新(推荐)和手动更新(macOS Homebrew、Linux AppImage 等)。
- 升级前检查:记录当前版本、查看发布说明、备份设置、导出扩展列表、提交未保存工作、记录自定义快捷键。
- 升级后验证:确认 Cursor 正常启动、登录状态、AI 功能、Tab 补全、扩展加载、自定义快捷键、项目规则加载和索引状态。
- VS Code 迁移:首次启动时自动导入设置、快捷键、用户代码片段、颜色主题和兼容扩展;也支持手动复制配置文件和重新安装扩展。
- 扩展市场差异说明:Cursor 使用 Open VSX Registry,部分 Microsoft 独占扩展不可用,可手动安装 .vsix。
- 跨机器迁移:导出扩展列表和设置文件,在新机器上恢复。
- 破坏性变更处理:如 .cursorrules 迁移到 .cursor/rules/,以及 Cursor 2.0 的变更说明。
- 企业考虑:托管部署、版本固定、设置模板和回滚。
使用方式
技能提供分步指令和检查清单。升级时先备份设置和扩展列表,再执行更新,最后逐项验证。迁移时利用首次启动的自动导入,或手动复制 settings.json、keybindings.json 和 snippets,并通过命令行重新安装扩展。跨机器迁移需导出扩展列表和设置文件,在新机器上恢复并检查平台特定设置。
适用场景
- 需要安全升级 Cursor 版本的个人开发者或团队。
- 从 VS Code 切换到 Cursor 并希望保留配置的用户。
- 在多台机器之间同步 Cursor 配置的开发者。
- 企业环境中需要受控部署和回滚策略的管理员。
限制
- 部分 Microsoft 独占扩展(如 GitHub Copilot、Live Share、Remote-SSH、C# Dev Kit)在 Cursor 中不可用。
- 扩展登录状态、数据库和工作区信任设置不会自动迁移。
- 任务配置(.vscode/tasks.json)会复制但可能需要调整。
- 平台特定设置(如终端默认配置文件、字体、文件监视排除路径)在跨机器迁移后需要手动检查。
- 具体版本兼容性和破坏性变更需查阅 changelog.cursor.sh。