WebStorm 2025.2 Help

书签

如果您处理大型项目,搜索文件和文件夹可能会耗费大量时间。 在这种情况下,WebStorm 提供了书签功能。 您可以为所需的代码行添加书签,以便更轻松地查找。 您还可以为您比其他项目项更常用的文件和文件夹添加书签。

您的所有书签都在 书签 工具窗口中按列表分组,您可以通过从主菜单中选择 视图 | 工具窗口 | 书签 或按下 Alt+2 打开该工具窗口。 该工具窗口还显示所有 断点 ,这些断点在您将其放入代码时会自动添加到专用列表中。

书签工具窗口

WebStorm 包含两种类型的书签:

  • 匿名书签 没有标识符,可让您添加任意数量的书签。 使用匿名书签标记的文件与代码行旁将显示书签图标。

  • 助记符书签 允许您使用数字(0 到 9)或字母(A 到 Z)创建书签。 使用助记符书签标记的文件与代码行旁将显示对应字母或数字图标,并带框显示。

添加书签

添加书签

WebStorm 会将您的书签添加至 书签 工具窗口中自动创建的预定义列表中,该列表名称与项目名称相同。 您可以 创建更多列表 ,并 设置其他默认列表

添加匿名行书签

  • 在编辑器中,将光标放在某一代码行并按下 F11

  • 或者,右键单击想要添加书签的代码行旁的边缘,然后选择 添加书签

    添加匿名书签

所选代码行旁的边缘将显示书签图标。

编辑区边缘的匿名书签

添加助记符行书签

  1. 在编辑器中,将光标放在某一代码行并按下 Ctrl+F11

    或者,右键单击想要添加书签的代码行旁的边缘,然后选择 添加助记书签

    添加助记符书签
  2. 在打开的弹窗中,选择一个数字或字母作为此书签的标识符。

    添加助记符书签:选择标识符

    如果所选助记符已被使用, IDE 会询问您是否要用新的书签覆盖现有书签。 选择 不再询问 选项以静默方式覆盖助记符。

    添加助记符书签:重写助记符弹窗
  3. 可选地,为新书签提供一个描述。

  4. Enter 或再次单击所选的字母或数字以保存书签。

    一个字母或数字书签图标将显示在已添加书签的行旁边的标尺中。

    编辑区边缘添加了助记符书签

为文件和文件夹添加书签

  1. 项目 工具窗口 Alt+1 中,右键单击要添加书签的项目,然后选择 书签 | 添加书签F11 )或 添加助记书签Ctrl+F11)。

    要为多个项目添加书签,请在工具窗口中选中它们,右键点击其中一个项目,然后选择 书签 | 添加书签F11)。

    为多个文件添加书签
  2. 对于助记符书签,请选择一个要用作此书签标识符的数字或字母。

    Enter 或再次单击所选的字母或数字以保存书签。

    为文件/文件夹添加书签

为编辑器选项卡添加书签

您可以逐个从编辑器选项卡中添加文件书签。 这些书签将添加到 默认列表

  1. 右键点击要添加书签的文件选项卡,并选择 书签 | 添加书签F11 )以添加匿名书签,或选择 添加助记符书签Ctrl+F11 )以添加带标识符的书签。

  2. 对于助记符书签,请选择一个要用作此书签标识符的数字或字母。

    Enter 或再次单击所选的字母或数字以保存书签。

为所有编辑器选项卡添加书签

您可以快速为所有打开的文件添加书签,并将它们添加到新列表中。

  1. 点击位于选项卡栏上的 最近文件、标签页操作及更多内容 图标 ,然后选择 为打开的标签页添加书签

  2. 为新列表命名。

    可以将此列表作为新书签的 默认列表 :启用 设为默认列表 选项。

    IDE 会创建一个新列表,并将所有打开选项卡中的文件添加到该列表中。

    为所有打开的选项卡添加书签

使用数字跳转到助记符书签

  • 按住 Ctrl 并在键盘上按下助记符数字。

    例如,要跳转到带有助记符 5 的书签,请按 Ctrl+5

使用字母跳转到助记符书签

默认情况下,没有为带字母助记符的书签跳转分配快捷键,但您可以自定义快捷键。

  1. Ctrl+Alt+S 打开设置,然后选择 键位映射

  2. 在快捷键列表中展开 其他 | 书签 | 按编号/助记符跳转 ,然后根据需要配置快捷键。

  3. 按配置好的快捷键即可在编辑器中跳转到字母书签。

默认情况下,没有为行书签跳转分配快捷键,但您可以自定义快捷键。

  1. Ctrl+Alt+S 打开设置,然后选择 键位映射

  2. 在快捷键列表中展开 其他 | 书签 ,为以下功能配置快捷键:

    • 下一行书签上一行书签 用于跳转所有行书签。

    • 编辑器中的下一行书签编辑器中的上一行书签 用于跳转打开文件中的书签。

  1. Shift+F11 或从主菜单进入 编辑 | 书签 | 显示行书签…

  2. 双击书签,或使用键盘选中后按 Enter

    对于助记符书签,按下对应的数字或字母。

默认情况下,WebStorm 在书签弹窗中仅显示行书签。 您可以配置设置以查看其他书签项(例如文件或文件夹):按 Ctrl+Alt+S 打开 IDE 设置,选择 高级设置 ,并禁用 仅在弹出窗口中显示行书签 选项。

  1. 在主菜单中,转到 视图 | 工具窗口 | 书签 或按 Alt+2 打开 书签 工具窗口。

  2. 展开所需的书签列表,或点击 全部展开 展开所有列表。

  3. 双击列表中的书签以跳转,或按:

    • Ctrl+Alt+Down导航 | 下一个书签位置 )跳转到下一个书签。

    • Ctrl+Alt+Up导航 | 上一个书签位置 )返回上一个书签。

修改书签

重命名书签

书签具有简短描述。 默认情况下,其包含该行的代码或书签所在项的名称。 如有需要,您可以为书签添加自定义简短描述。

  1. 按住 Alt 并点击编辑器标尺中的书签图标。

    您也可以右键点击编辑器标尺中的书签图标、 项目 工具窗口 Alt+1 中已添加书签的项目,或者 书签 工具窗口中的书签,然后选择 重命名书签…

  2. 在打开的对话框中,指定新描述并点击 确定(O)

    重命名书签

您可以在 书签 工具窗口或编辑器中查看书签描述:将鼠标悬停在标尺中的书签图标上,即可查看包含书签描述的工具提示。

在弹窗中查看书签的描述

为匿名书签分配助记符

您可以将匿名书签转换为助记符书签。

  1. 右键点击编辑器标尺中的书签图标、 项目 工具窗口 Alt+1 中的书签项或 书签 工具窗口中的书签,然后选择 分配助记键 (或按 Ctrl+F11)。

    为匿名书签分配助记符
  2. 在打开的弹窗中,选择要用作此书签标识符的数字或字母。

    可选地,提供一个描述。

  3. Enter 或再次单击所选的字母或数字以保存书签。

更改助记符标识符

  1. 右键点击编辑器标尺中的书签图标、 项目 工具窗口 Alt+1 中的书签项,然后选择 更改助记键 (或按 Ctrl+F11)。

    更改书签的助记符标识符
  2. 在打开的弹窗中,选择另一个标识符。 如有需要,也可以更改描述。

  3. Enter 或再次单击所选的字母或数字以保存书签。

取消助记符书签的标识

您可以将助记书签转换为匿名书签。

  • 右键点击编辑器边距中的书签图标、 项目 工具窗口中的已加书签的项目 Alt+1 ,或 书签 工具窗口中的书签,然后选择 移除助记键

    从编辑区边缘取消助记符书签的标识

删除书签

  • 要从 书签 工具窗口或边距中删除书签,请右键点击该书签并选择 删除书签

  • 要从 项目 工具窗口 Alt+1 中删除书签,请右键点击已加书签的项目并选择 书签 | 删除书签

书签列表

存在一个预定义的空书签列表,与项目同名。 默认情况下,WebStorm 会将您的书签添加到该处。 如有需要,您可以将另一个列表设置为默认列表。 您还可以创建多个列表并在列表之间移动项目。

创建书签列表

  1. 在主菜单中,转到 视图 | 工具窗口 | 书签 或按 Alt+2 打开 书签 工具窗口。

  2. 在工具窗口中,点击 创建书签列表 ,并在打开的对话框中为新列表命名。

    创建书签列表图标
  3. 如果希望书签自动添加到此列表中,请启用 用作默认列表 选项,然后点击 创建

    创建新书签列表

将书签移动到其他列表

  • 转到 视图 | 工具窗口 | 书签 或按 Alt+2 打开 书签 工具窗口,然后将书签拖动到另一列表。

  • 项目 工具窗口 Alt+1 中,右键点击已加书签的项目并选择 书签 | 将书签添加到另一个列表

排序书签

  • 要在列表中上移或下移书签,请在 书签 工具窗口中右键点击该书签,然后选择 上移(U)下移(D)

  • 要在工具窗口中按文件分组显示行书签,请在 书签 工具窗口中点击 选项 ,然后选择 按文件将行书签分组 选项。

更改默认列表

WebStorm 会将所有书签添加到配置为默认列表的书签列表中。 如有需要,您可以为书签使用其他默认列表。

  1. 在主菜单中,转到 视图 | 工具窗口 | 书签 或按 Alt+2 打开 书签 工具窗口。

  2. 右键点击您希望用作默认书签列表的列表,并选择 将列表标记为默认

    设置默认书签列表

    此列表现在位于工具窗口中其他列表之上,并具有 默认 标签。

    书签工具窗口中的默认列表

删除书签列表

删除列表后,该列表中的所有书签都将从代码和项目项中移除。

  1. 在主菜单中,转到 视图 | 工具窗口 | 书签 或按 Alt+2 打开 书签 工具窗口。

  2. 右键点击您希望删除的列表并选择 删除书签列表

最后修改日期: 2025年 9月 26日