在 PhpStorm 中，按 Ctrl+F11（Win/Linux）或 Cmd+F11（macOS）可添加/取消行级书签，命名书签支持 Shift+F11 列表搜索跳转，匿名书签仅限当前文件循环跳转，书签随行删除而自动消失，不共享、不导出，与基于注释的 TODO 机制完全不同。
怎么在 PhpStorm 里加行级书签
直接按 ctrl + f11（windows/linux）或 cmd + f11（macos），光标所在行就打上一个匿名书签；再按一次取消。这不是收藏夹，是“临时锚点”——关掉文件或重启 ide 不会丢，但删了那行代码，书签就自动消失。
想带标签方便识别？先按 Ctrl + F11 打上基础书签，松手后立刻再按一次 F11，弹出输入框，输个简短名字比如 auth_check 或 todo_refactor。别用空格或特殊符号，IDE 只认字母、数字和下划线。
- 书签默认显示在编辑器左侧的灰色标记栏，带小书本图标；命名书签会额外显示首字母（如
a表示auth_check） - 匿名书签无法跨文件搜索，命名书签可以——这点常被忽略
- 别指望鼠标右键菜单里找“添加书签”，它藏在键盘快捷键里，没入口
怎么快速跳转到某个书签
按 Shift + F11 调出书签列表，里面按字母序排着所有命名书签，支持模糊搜索：输 auth 就能定位到 auth_check；输 tod 匹配 todo_refactor。回车确认，光标瞬间跳过去。
匿名书签不进这个列表，只能靠 Ctrl + Shift + F11（Windows/Linux）或 Cmd + Shift + F11（macOS）在当前文件内循环跳转——但它不分命名/匿名，只按顺序扫一遍所有已设行。
- 如果跳转后发现光标没动，大概率是书签所在行已被删除或折叠，检查代码结构是否变化
- 列表里看到重复名字？那是你在不同文件打了同名书签，IDE 不校验唯一性
-
Shift + F11列表不支持排序或分组，纯靠命名规范来管理
书签和 TODO 工具的区别在哪
书签是人工标记的「位置锚点」，和内容无关；TODO 是基于注释关键字（如 // TODO）自动扫描的「语义线索」。两者底层机制完全不同：书签存在 IDE 的本地配置里（路径类似 .idea/workspace.xml），TODO 依赖正则匹配，可配置但不保存具体行号。
立即学习“PHP免费学习笔记（深入）”；
这意味着：你删掉一行带 // TODO 的代码，下次扫描就没了；但删掉一行带书签的代码，IDE 会默默把书签移除，不报错也不提醒。
- 调试时临时盯住某几行逻辑？用书签。梳理待办事项？用 TODO
- 书签不能导出，不能共享给同事；TODO 可以统一配置规则，团队共用一套关键词
- 误把
// FIXME当书签用？它不会响应Shift + F11，得先在Settings > Editor > TODO里加上该模式
为什么有时候书签突然不见了
最常见原因是启用了「只显示当前文件书签」视图模式。按 Shift + F11 后，窗口右上角有个小按钮，图标是两个重叠文档——点一下切到「All bookmarks」，否则默认只列当前打开文件里的书签。
另一个隐蔽原因：项目用了 Git 分支切换，而书签信息存在 .idea/workspace.xml，这个文件通常被 .gitignore 排除了。换分支后，workspace.xml 恢复成旧版本，新打的书签就丢了。
- 别手动编辑
workspace.xml维护书签，容易格式错乱导致整个文件失效 - 多人协作项目里，书签纯属个人工作流，别把它当代码逻辑的一部分去依赖
- 如果频繁丢失，检查
Settings > Appearance & Behavior > System Settings里是否勾选了Synchronize files on frame activation，关闭它有时能减少状态错位
书签不是状态同步机制，它只是帮你少翻几次页——记住了位置，不代表记住了上下文。
