Cursor 更新/回退/完全卸载

解决什么问题

三类诉求，一篇文章讲完：一是自动更新不合心意——新版改了交互、扩展出兼容问题，想把版本固定住；二是升级之后出问题，需要回退到旧版本继续干活；三是换机器或不再使用时，把 Cursor 从系统里彻底清干净。顺带解决一个高频疑问：重装之后配置还在不在？

三件事共用同一套目录模型知识：搞清楚程序本体、用户数据、机器级配置分别放在哪，更新、回退、卸载就都变成”对哪个目录做什么”的问题，学会一次全都会。

环境与版本

• 系统：Windows 11 为主，macOS 的对照路径在卸载一节给出
• Cursor：版本与安装方式【待补：Help → About 查看版本号；安装方式分用户级与系统级，见第一步】
• 关键认知：Cursor 是 VS Code 的 fork，目录模型完全同构——程序本体、用户数据、机器级配置三块分离。理解这一点，更新、回退、卸载全都清晰

Windows 下的目录分工（与 VS Code 同构）：
%LOCALAPPDATA%\Programs\cursor    程序本体：升级和卸载动的是这里
%APPDATA%\Cursor                  用户数据：settings.json、会话历史、workspaceStorage、各类缓存
%USERPROFILE%\.cursor             机器级配置：扩展目录、全局 mcp.json
%LOCALAPPDATA%\cursor-updater     更新缓存（以实际机器为准）

重装和升级只覆盖程序本体，用户数据与扩展原地不动——这就是”重装配置还在”的原因，而且是我们要的默认行为：配置保留是常态，彻底清除才需要额外动手。

分步骤

第一步：确认版本与安装方式

Help → About 查看版本号。用户级安装（默认）装在 %LOCALAPPDATA%\Programs\cursor；系统级安装在 Program Files，需要管理员权限。拿不准装的是哪种，看资源管理器里有没有 %LOCALAPPDATA%\Programs\cursor 这个目录即可。本文命令按用户级写，系统级路径自行对应。

第二步：关闭自动更新（想固定版本先做这个）

Cursor 沿用 VS Code 的更新设置，settings.json 里一行：

{
  // update.mode 与 VS Code 同源，"none" 表示不检查也不自动安装更新
  // 是否能拦住当前版本的全部更新通道，以实测为准：【待补】
  "update.mode": "none"
}

第三步：更新到指定版本（覆盖安装）

从官网下载目标版本的安装包直接覆盖安装，配置与扩展不受影响；用 winget 也行：winget upgrade Anysphere.Cursor（包 id 以 winget search cursor 的实际输出为准）。升级前先扫一眼官方 changelog（cursor.com/changelog），确认没有你依赖的功能被移除、没有已知性能回归。

第四步：回退旧版本

官方没有一键回退按钮，可行路径是：先做第二步关掉自动更新（否则回退完立刻被升回去），再从官方渠道获取旧版安装包覆盖安装【待补：官方旧版本安装包的获取入口——changelog 页或下载页的具体链接】。两条红线：不要用第三方站点下载的”绿色版/精简版”，供应链风险担不起；回退前把 %APPDATA%\Cursor 整个复制一份做备份——新版本写入的工作区状态旧版本能否正常读【待补：实测结论】，有备份才有退路。

第五步：重装保留配置（换机、修疑难杂症）

走正常卸载（设置 → 应用 → Cursor → 卸载，或 winget uninstall Anysphere.Cursor），不要手动删数据目录。新机器装好后，把两块配置搬过去：%APPDATA%\Cursor 带设置与会话历史，%USERPROFILE%.cursor 带扩展与全局配置。卸载前导出扩展清单备用：

# CLI 参数与 VS Code 同源（以你的版本实测为准）
cursor --list-extensions | Out-File cursor-extensions.txt

第六步：完全卸载（确认不再用了再做）

先正常卸载程序本体，然后清理残留。注意：这一步会连会话历史、MCP 配置一起删掉，执行前确认真的不需要了。

# 关闭 Cursor 后逐项确认删除
Remove-Item -Recurse -Force "$env:USERPROFILE\.cursor"           -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\Cursor"                -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Programs\cursor"  -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\cursor-updater"   -ErrorAction SilentlyContinue

macOS 对照：

rm -rf /Applications/Cursor.app
rm -rf ~/.cursor
rm -rf ~/Library/Application\ Support/Cursor

长期使用后这几块合计能到 2~5 GB（缓存类目录是累积大户，Electron 应用的公认量级），其中仅 Cache 与 CachedData 两项过 1 GB 也不罕见，全清之后磁盘回收立竿见影【待补：你机器上清理前后的实测体积】。

常见坑

坑一：卸载完重装，发现”配置怎么还在”。因为 %APPDATA%\Cursor 没删——这是特性不是残留，正是它保证重装不丢配置。要彻底干净就走第六步，两条路径别搞混。

坑二：一刀切删 %USERPROFILE%.cursor。里面的 mcp.json 是你调好的 MCP 服务器配置，删了要逐个重配【待补：确认 mcp.json 的确切路径后补充】。先单独备份这一个文件，再清目录。

坑三：回退后自动更新立刻把它升回去。顺序错了：必须先关 update.mode，再覆盖安装旧版；顺序反了等于白做。很多”回退失败”的案例其实是顺序问题，不是版本不兼容。

坑四：把 workspaceStorage 当缓存清理。里面存的是各工作区的会话历史与界面状态，删了不可恢复。清缓存只动 Cache 类目录，安全清单见 Cursor 越用越卡：索引/缓存/性能排查。

最终效果

版本固定后不再被自动更新打断工作流；回退有备份兜底，进退都有路；完全卸载后程序、数据、配置三层残留清零，机器回到没装过 Cursor 的状态。整套流程演练一遍大约十几分钟，多数时间花在等安装包下载【待补：你的实测耗时】。

相关阅读

• Cursor 越用越卡：索引/缓存/性能排查
• Cursor 安装指南