Cursor使用

lishihuan大约 5 分钟

Cursor使用

历史版本下载open in new window

https://hiioj3vbs6o.feishu.cn/wiki/JGtHwp6fyif07vkHjQNcQEV6nwNopen in new window

1. 设置中文

  • 扩展程序设置
    • 按下键盘组合键 Ctrl+Shift+X，进入扩展程序页面
    • 在搜索框中输入 “Chinese”，搜索中文语言包。
    • 在搜索结果中找到合适的中文语言包，点击 “安装” 按钮
    • 安装完成后，关闭 Cursor 软件并重新启动，界面将切换为中文
  • 配置语言设置
    • 按下键盘组合键 Ctrl+Shift+P，打开命令面板
    • 在命令面板的搜索框中输入 “configure display language”，按下回车键
    • 在弹出的语言配置页面中，选择 “中文（简体）” 作为显示语言
    • 点击 “保存” 按钮，然后关闭并重新启动 Cursor 软件，界面将切换为中文

2. 取消自动更新

1 打开 cursor 编辑器

2 在顶部菜单栏，点击file(windows) 或 Cursor(mac)

3 选择Preferences -> Settings 【首选项-> 设置】

4 在搜索框中输入update ，找到 “Update：Mode” 选项。

5 将其更改为manual 这样Cursor 只会在你手动检查更新时才更新了

image-20250516110642395
image-20250516110642395

备份

Cursor 聊天记录丢失、上下文无法延续，核心原因是它本地存储、无云端同步、重启/新窗口易丢失历史。要在新窗口快速找回上下文，可从 预防备份、快速恢复、自动存档、新会话续聊 四方面解决，以下是最实用、可直接操作的方案：

一、先定位：Cursor 聊天记录存在哪里（本地）

不同系统路径（新版本 v44.9+ 通用）：

  • Windows
    • 全局聊天：%APPDATA%\Cursor\User\globalStorage\cursor.chat
    • 工作区聊天：%APPDATA%\Cursor\User\workspaceStorage\<hash>\state.vscdb (SQLite)
    • LevelDB 缓存：%APPDATA%\Cursor\User Data\Default\Local Storage\leveldb
  • macOS
    • 全局：~/Library/Application Support/Cursor/User/globalStorage/cursor.chat
    • 工作区：~/Library/Application Support/Cursor/User/workspaceStorage/<hash>/state.vscdb
  • Linux
    • 全局：~/.config/Cursor/User/globalStorage/cursor.chat
    • 工作区：~/.config/Cursor/User/workspaceStorage/<hash>/state.vscdb

关键：关闭 Cursor 再操作文件，否则会被锁定/覆盖。

二、预防丢失：3种自动/手动备份（必做）

1. 手动导出（单会话，最稳）

  • 打开对话 → 右上角 ... → Export chat
  • 选 Markdown 保存到项目目录（如 docs/chat-xxx.md）
  • 优点：结构清晰、可直接阅读、Git 可追踪

2. 自动定时备份（全历史，防崩）

Windows 脚本（保存为 .bat 定时运行）

@echo off
set BACKUP_DIR=D:\CursorBackups
set CHAT_DIR=%APPDATA%\Cursor\User\globalStorage\cursor.chat
set LEVELDB_DIR=%APPDATA%\Cursor\User Data\Default\Local Storage\leveldb
set DATE=%date:~-4,4%%date:~-10,2%%date:~-7,2%

if not exist "%BACKUP_DIR%" mkdir "%BACKUP_DIR%"
xcopy "%CHAT_DIR%" "%BACKUP_DIR%\chat-%DATE%\" /E /I /Y
xcopy "%LEVELDB_DIR%" "%BACKUP_DIR%\leveldb-%DATE%\" /E /I /Y
echo 备份完成：%BACKUP_DIR%

macOS/Linux 脚本（.sh 加入 crontab）

#!/bin/bash
BACKUP_DIR="$HOME/CursorBackups"
CHAT_DIR="$HOME/Library/Application Support/Cursor/User/globalStorage/cursor.chat"
LEVELDB_DIR="$HOME/Library/Application Support/Cursor/User Data/Default/Local Storage/leveldb"
DATE=$(date +%Y%m%d)

mkdir -p "$BACKUP_DIR"
cp -R "$CHAT_DIR" "$BACKUP_DIR/chat-$DATE/"
cp -R "$LEVELDB_DIR" "$BACKUP_DIR/leveldb-$DATE/"
echo "Backup done: $BACKUP_DIR"
  • 设置 每日/每小时自动执行，彻底防丢失。

3. 插件自动存档（推荐：SpecStory）

三、已丢失：2种快速恢复方法

1. 从备份恢复（有备份时）

  1. 完全退出 Cursor
  2. 用备份的 cursor.chat / leveldb 文件夹 覆盖 原目录
  3. 重启 Cursor → 历史全部恢复

2. 从本地数据库提取（无备份、刚丢失）

  • 工具：cursor-history（开源，可导出所有聊天）
npm install -g cursor-history
# 导出全部为 Markdown
cursor-history export --format md --output ./cursor-chats/
  • 输出：按会话分 .md，可直接搜索、阅读、复用。

四、新窗口快速续聊：上下文一键加载

方法 1：Checkpoint Skill（官方风格存档/读档）

  • 安装：克隆到 ~/.cursor/skills/checkpoint/
git clone https://github.com/getcursor/checkpoint-skill ~/.cursor/skills/checkpoint
  • 使用：
    • 存档：输入 ctx save 完成用户登录接口 → 自动生成带摘要的 .md
    • 读档：新窗口输入 ctx load → 选择历史存档 → AI 自动加载上下文

方法 2：手动“喂上下文”（最快）

  • 新会话开头直接粘贴：
    以下是之前对话上下文，请先理解再回答：
---
（粘贴导出的 Markdown/关键内容）
---
现在继续：我要接着做xxx
  • 优点：10秒恢复上下文，不受窗口/重启影响。

方法 3：用 Cursor Chat Transfer 迁移会话

五、最佳实践（日常这样用，永不丢上下文）

  1. 关键对话必导出：用 Markdown 存项目 docs/chat/
  2. 开启 SpecStory：后台自动全量存档
  3. 每日自动备份：脚本备份 leveldb + cursor.chat
  4. 新会话先 ctx load / 粘贴上下文：10秒续上进度

六、SpecStory插件介绍的使用

https://blog.csdn.net/apache2tomcat/article/details/145975769open in new window

安装步骤

  • 下载安装包 两种方式下载安装包：

  • 在Cursor中安装，以下两种安装方式之一：

    • 方式一：命令面板安装
      • 打开Cursor编辑器
      • 按下快捷键 Ctrl+Shift+P（Windows）或 Cmd+Shift+P（Mac）打开命令面板
      • 输入并选择 Extensions: Install from VSIX...
      • 选择下载好的specstory-vscode-latest.vsix文件
      • 等待安装完成
    • 方式二：拖拽安装
      • 打开Cursor编辑器
      • 点击左侧扩展图标（或按 Ctrl+Shift+X）打开扩展页面
      • 直接将下载好的specstory-vscode-latest.vsix文件拖入扩展页面
      • 等待安装完成

  • 验证安装 再次打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P） 输入"SpecStory" 如果能看到相关命令，说明安装成功

快速上手

  • 开启自动保存（默认已开启）
    • 打开命令面板 Ctrl+Shift+P
    • 输入 SpecStory: Auto Save
    • 点击启用自动保存功能

  • 关闭云端同步功能

  • 查看保存的对话
    • 在Cursor中打开任意项目
    • 左侧资源管理器中会出现 .specstory 文件夹
    • 所有对话历史都保存在 .specstory/history 目录中
    • 对话内容以Markdown格式保存，可直接查看和编辑
  • 分享对话 在对话完成后，打开命令面板 输入 SpecStory: Share Composer and Chat History 获取分享链接，可发送给其他人查看