在 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 依赖正则匹配，可配置但不保存具体行号。

这意味着：你删掉一行带 // 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，关闭它有时能减少状态错位

书签不是状态同步机制，它只是帮你少翻几次页——记住了位置，不代表记住了上下文。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！