在 Windows 安装 Cursor，最重要的是从官方页面取得安装程序、核对来源，并在导入大量编辑器配置前完成一次小型项目检查。本文还会区分“Cursor 官方中文文档”和“桌面界面语言”，避免把来历不明的中文修改版当成官方软件。
检查 Windows 要求和下载来源
Cursor 当前快速入门列出 Windows 10 或更高版本，并提供原生 .exe 安装程序。请访问 Cursor 官方下载页核对当前版本和支持平台。不要使用所谓绿色版、破解包、第三方镜像或“中文特供版”，它们可能过期、被修改或预装未经审查的扩展。
运行安装程序前：
- 保存工作并关闭其他编辑器窗口；
- 确认文件来自 Cursor 官方域名；
- 为编辑器、扩展和项目索引预留磁盘空间；
- 公司设备先确认软件与扩展安装政策。
在 Windows 安装 Cursor
- 运行下载的
.exe安装程序。 - 按照 Windows 提示完成安装。
- 从开始菜单打开 Cursor。
- 设置快捷键、主题和终端偏好。
- 需要账号对应 AI 功能时，按照当前界面完成登录。
如果跳过了初始引导，可按 Ctrl+Shift+P 打开命令面板，搜索 Cursor: Start Onboarding，重新执行当前版本提供的设置步骤。
谨慎导入 VS Code 设置
Cursor 基于 VS Code 代码库，因此迁移体验较熟悉。但一次导入所有内容，也可能带来快捷键冲突、重复的 AI 扩展或公司专用配置。
更稳妥的顺序是：
- 先导入主题和键盘偏好；
- 打开一个熟悉的项目，检查终端和源代码管理；
- 只安装该项目需要的语言和工具扩展；
- 逐个添加其他扩展，并重新测试补全和 Agent。
Cursor 扩展文档说明，其扩展目录并不是 Microsoft Marketplace 的直接复制。应像检查软件依赖一样，核对发布者、扩展标识和来源。
设置 Cursor 中文界面
Cursor 官网和文档可能提供中文页面，但不代表每个桌面版本都内置相同语言包。请在当前应用中检查：
- 按
Ctrl+Shift+X打开 Extensions。 - 搜索简体中文或繁体中文语言包。
- 安装前检查发布者、权限、维护状态和注册表来源。
- 打开命令面板，若存在
Configure Display Language，则运行该命令。 - 选择已安装语言，并按提示重启 Cursor。
如果 Cursor 当前扩展目录没有可信语言包，宁可继续使用英文界面，也不要下载重新打包的安装程序。即使界面是英文，仍可直接使用中文提示词并要求中文解释。
打开第一个项目并检查环境
选择 File → Open Folder，打开仓库根目录，然后确认：
- Explorer 显示预期源码和配置文件；
- Source Control 显示正确分支与未提交改动；
- 集成终端位于正确工作目录；
- 项目原有测试或构建命令可以运行；
- Agent 能解释选定文件，而且没有修改内容。
最后一项可用只读提示词检查：
根据项目自身文档，说明主要构建和测试命令。
不要修改文件，也不要执行命令。指出支持回答的具体文件。Windows 安装常见问题
Windows 阻止或警告安装程序
返回官方下载页核对来源。公司受管设备不要绕过安全策略，应让管理员审核安装程序和必要网络域名。
Cursor 能打开但 Agent 无法登录
检查系统时间、浏览器登录流程、代理和组织网络政策。不要把登录令牌粘贴到对话或截图中；账号权限与套餐限制以当前 Cursor Dashboard 为准。
终端使用了错误的 shell
重新打开引导或在终端设置中选择本机已经安装的 shell。先手动验证项目命令，再让 Agent 执行。
中文显示乱码
先区分界面语言与文件编码。确认源文件为 UTF-8，选择覆盖中文字形的字体，并检查终端编码。语言包无法修复编码错误的源文件。
扩展导致 AI 补全异常
Cursor 故障排查建议先禁用扩展，再逐个启用定位冲突。其他 AI 补全扩展和拦截快捷键的扩展应优先检查。
用一个受控任务完成安装验证
环境稳定后，按照 Cursor 新手入门教程完成代码库解释、小范围修改、差异审查和项目检查。不要拿重要生产仓库作为安装测试项目。