VSCode光标位置分三层存储:内存缓存(进程级,不持久)、session.json(记录已保存文件的光标与滚动偏移)、workspaceStorage(按工作区存储已保存文件的光标与折叠状态)。

光标位置到底存在哪几个地方?
VSCode 的光标位置不是只存一份,而是分层写入三类位置:内存缓存、会话状态文件、工作区元数据。其中只有后两者能跨重启生效,且都依赖文件是否已保存。
-
内存缓存:实时响应但进程退出即丢,未保存的Untitled-1就靠它维持当前光标 -
session.json(位于%APPDATA%\Code\Local Storage\):记录最近打开的编辑器窗口及其中每个已保存文件的光标行/列、滚动偏移,但不包含未保存内容 -
workspaceStorage(位于%APPDATA%\Code\WorkspaceStorage\):按工作区哈希目录组织,存每个打开文件的最后光标位置和折叠状态,仅对加入工作区的已保存文件生效
为什么“Ctrl+S 一下”就能让光标记住位置?
因为 VSCode 的持久化逻辑是“文件路径绑定”,而非“标签页绑定”。没有路径的临时文件(如粘贴生成的 Untitled-1 或命令行 code -r 打开的无名内容)不会写入 session.json 或 workspaceStorage。
- 一旦执行
Ctrl+S并指定路径,VSCode 立即为该文件生成唯一 URI,并将其纳入状态跟踪体系 - 后续所有光标移动、滚动、折叠操作都会被异步写入对应存储位置,延迟通常在 500ms 内
- 远程开发(SSH/WSL)下若路径映射中断(比如远程服务重启),
workspaceStorage中的路径匹配失败,也会导致位置丢失——此时看状态栏右下角Remote标识是否稳定在线
哪些设置会干扰光标位置记忆?
多数设置不影响核心机制,但有三个关键开关值得检查:
-
editor.stickyScroll.enabled:开启后滚动锚点可能轻微偏移,属于渲染层行为,不影响实际存储的行号/列号值 -
files.autoSave设为off不影响位置记忆,但若用户长期不保存,就等于始终停留在内存缓存层 -
workbench.editor.restoreViewState必须为true(默认),否则即使文件已保存,VSCode 也不会尝试恢复视图状态
如何手动验证或清理异常的位置记录?
当发现某文件总跳回旧位置,大概率是 workspaceStorage 中残留了错误状态。可定位并删掉对应条目,无需重启编辑器:
- 打开命令面板(
Ctrl+Shift+P),运行Developer: Open Workspace Storage Folder - 进入子目录,找名字含当前工作区哈希的文件夹,再进
state.json - 搜索文件路径(注意是 URI 编码格式,如
file%3A%2F%2F%2Fc%3A%2Fproject%2Fmain.c),删掉整段"editorViewState"节点 - 保存后重新打开该文件,位置将重置为 0 行 0 列,之后的操作会重新记录
真正容易被忽略的是:远程开发中路径映射变化后,旧的 workspaceStorage 条目不会自动失效,得手动清——这点比本地环境更隐蔽。


















