f11是仅绑定行号的临时匿名书签,不跨文件、不存描述、不进shift+f11面板;ctrl+f11是可设助记符(0–9/a–z)、支持跨文件跳转与描述、保存于.workspace.xml的持久化书签。

F11 和 Ctrl+F11 不是同一种书签,混用会导致跳转失效或找不到目标行。
匿名书签(F11)只绑定行号,不记文件、不跨文件稳定存在
它只是编辑器左侧 gutter 里的一个蓝色小方块,作用范围仅限当前打开的文件。插入/删除上方行时,书签会跟着上下浮动;整行被删,书签自动消失。适合临时标记“正在调试的 if 分支”或“待补全的 setup() 函数”,但不适合长期导航。
- 关掉再打开文件,书签还在;切换 Git 分支后若该行被移除,书签就没了,IDE 不提示
- 在
.vue文件里尤其容易错位——<template></template>里按 F11,删两行 HTML,书签可能直接落到<script></script>区甚至注释里 - 不保存到
.idea/workspace.xml,不进Shift+F11面板,纯靠视觉识别,无法搜索或批量管理
助记符书签(Ctrl+F11)才是可跳转、可描述、跨文件的真锚点
按 Ctrl+F11(Windows/Linux)或 Cmd+F11(macOS)呼出选择框,选一个 0–9 或 a–z 作为标识符。之后用 Ctrl+5 或 Ctrl+B 就能瞬时跳转,哪怕目标文件已关闭。
- 同一编号重复使用会覆盖旧书签,不是新增;建议固定
#0给主入口、#1给核心逻辑,别贪多 - 可填描述(如
B: useFetch loading 状态处理),在Shift+F11面板可见,且是面板内唯一支持搜索的字段 - 保存在本地
.idea/workspace.xml,Git 默认忽略,团队间不同步——同事 clone 仓库后看不到你的Ctrl+8
Ctrl+数字跳不到预期位置?大概率是跨项目残留书签
最常见现象:你在项目 A 打了 #7,后来关掉 A 去开发项目 B,没清理,结果在 B 里按 Ctrl+7,WebStorm 强行跳回 A 的旧路径——哪怕 A 根本没打开,甚至路径已不存在。
- 解决方法不是重启 IDE,而是立刻按
Shift+F11,在面板里找到对应编号,右键 →Remove;或直接按Ctrl+Shift+7把它重定位到当前文件合理位置 -
Shift+F11面板里的路径是绝对路径,重命名文件夹后不会自动更新,双击可能报 “File not found” -
Remove All Bookmarks只清 F11 类型,不会动 Ctrl+F11 编号书签,这点常被误判
Vue 项目中书签和 TODO 工具窗口完全无关
书签是人工打的位置锚点,和代码内容无关;TODO 是靠扫描 // TODO 注释自动发现的语义线索。删掉带书签的一行,书签消失;删掉一行 // TODO,下次扫描就没了——但两者互不影响。
- 别指望用书签替代
// TODO: @bookmarked这类注释方案,后者能随 Git 提交、被团队看到 - 助记符书签快捷键(如
Ctrl+B)在 macOS 上易与系统级Cmd+B(加粗)冲突,建议去Settings → Keymap确认是否被劫持 - 真正难维护的是描述字段:写
#2: loading没用,Vue 里满屏都是 loading;得写成#2: useAuthStore().isAuthenticated才能在Shift+F11里快速识别











