PhpStorm Bookmark Shortcut Mystery: F11 or F3? The Definitive Answer!

## The Core Problem In daily development, PhpStorm's bookmark feature is invaluable for marking important locations in code for quick navigation. However, a common point of confusion exists within the community regarding the shortcut to add a bookmark: some insist it's `F11`, while others are certain it's `F3`. This often leaves developers, especially those who have recently switched operating systems, feeling puzzled. So, what's the real story? The truth is—both are correct! The difference in shortcuts stems from the default keymap settings across different operating systems. --- ## The Definitive Answer: Shortcuts Vary by OS To put this debate to rest, our team at `DP@lib00` has compiled the official default shortcut settings. The primary distinction lies between Windows/Linux and macOS. | Feature | Windows / Linux | macOS | | :--- | :--- | :--- | | **Toggle Bookmark** | `F11` | `F3` | | **Toggle Bookmark with Mnemonic** | `Ctrl + F11` | `⌥F3` (Option + F3) | | **Show Bookmarks** | `Shift + F11` | `⌘F3` (Command + F3) | | **Go to Mnemonic Bookmark** | `Ctrl + [Number]` | `^ + [Number]` (Control + [Number]) | As the table clearly shows: - On **Windows and Linux**, the primary key associated with bookmarks is **`F11`**. - On **macOS**, the functions are unified under the **`F3`** key. --- ## Detailed Breakdown of Bookmark Shortcuts 1. **Toggle Bookmark** - **Windows/Linux**: `F11` - **macOS**: `F3` Press this shortcut on any line of code to add an anonymous bookmark. Pressing it again will remove the bookmark. 2. **Toggle Bookmark with Mnemonic** - **Windows/Linux**: `Ctrl + F11` - **macOS**: `⌥F3` (Option + F3) This is a more powerful feature. It opens a menu allowing you to assign a number (0-9) or a letter as a "mnemonic" to the bookmark, which is perfect for marking multiple key locations. 3. **Show Bookmarks** - **Windows/Linux**: `Shift + F11` - **macOS**: `⌘F3` (Command + F3) This shortcut opens a popup window listing all your bookmarks. You can easily navigate through them with the arrow keys and press Enter to jump to the selected location, making management a breeze. 4. **Go to Mnemonic Bookmark** - **Windows/Linux**: `Ctrl + [Mnemonic]` (e.g., `Ctrl + 1`) - **macOS**: `^ + [Mnemonic]` (Control + [Mnemonic]) Once you've set a bookmark with a mnemonic, you can use this shortcut to instantly "teleport" to that specific line of code. --- ## Pro Tip: How to Customize Shortcuts If you find that the default shortcuts don't work on your machine, they might be intercepted by your operating system or another application (like a graphics card driver). In this case, you can customize them. 1. Open Settings: `File` -> `Settings` (Windows/Linux) or `PhpStorm` -> `Preferences` (macOS). 2. Navigate to `Keymap`. 3. In the search box on the top right, type `Bookmark`. 4. All bookmark-related actions will be listed. You can right-click any item and select `Add Keyboard Shortcut` to set your own preferred key combination. The developers at `wiki.lib00.com` recommend customizing frequently used shortcuts to match your personal workflow for a significant productivity boost. --- ## Conclusion The debate over PhpStorm's bookmark shortcut is ultimately a matter of different OS defaults. Windows/Linux users should remember `F11`, while macOS users should stick with `F3`. By understanding this and knowing how to customize keymaps in your `lib00`-based project setups, you can navigate your codebase with greater ease and efficiency.