VS Code Shortcuts on Windows vs Mac: What Actually Changes
Most VS Code shortcuts map straight from Cmd to Ctrl, but a handful genuinely differ. Here are the ones that break when you switch between Windows and Mac, and the keys that only exist on one side.
The rule, and its exceptions
Switching VS Code between Windows and Mac is mostly a find-and-replace in your head:
- Cmd becomes Ctrl
- Opt becomes Alt
That covers the large majority of shortcuts. Save, find, command palette, multi-cursor, go to file — all of them translate directly. The problem is the handful that do not, because those are the ones that silently do something else instead of nothing.
This guide lists only the differences. If a shortcut is not here, the rule above applies.
The differences that bite
| Action | Mac | Windows |
|---|---|---|
| Go back to the previous location | Ctrl + Minus | Alt + Left |
| Go forward | Ctrl + Shift + Minus | Alt + Right |
| Fold a code block | Cmd + Opt + [ | Ctrl + Shift + [ |
| Unfold a code block | Cmd + Opt + ] | Ctrl + Shift + ] |
| Replace | Cmd + Opt + F | Ctrl + H |
| Split the terminal | Cmd + Backslash | Ctrl + Shift + 5 |
Navigate back is the one worth internalizing. On Mac it uses Ctrl, not Cmd, which breaks the translation rule twice over — and on Windows it is not a Ctrl shortcut at all. If you jump to a definition and want to come back, this is the key you need and the one you will fumble.
Folding is the other trap: on Mac the modifier is Cmd + Opt, on Windows it is Ctrl + Shift. Pressing Ctrl + Alt + bracket on Windows does nothing at all.
The terminal split is listed here for completeness, but it is the gentlest of the four: Ctrl + Shift + 5 also works on Mac as a secondary binding, so that one key covers both machines.
The terminal keeps Ctrl on both
One group resists the Cmd rule entirely. Ctrl + Backtick (toggle the terminal) and Ctrl + Shift + Backtick (new terminal) are Ctrl shortcuts on macOS too — not Cmd. They are the same on both platforms, which makes them easy to forget when every other editor shortcut on a Mac starts with Cmd.
What does translate cleanly
For reassurance, these all follow the rule — the Mac key with Cmd becomes the same key with Ctrl on Windows:
| Action | Mac | Windows |
|---|---|---|
| Command palette | Cmd + Shift + P | Ctrl + Shift + P |
| Quick open a file | Cmd + P | Ctrl + P |
| Save | Cmd + S | Ctrl + S |
| Find | Cmd + F | Ctrl + F |
| Toggle the terminal | Ctrl + Backtick | Ctrl + Backtick |
| Toggle the sidebar | Cmd + B | Ctrl + B |
| Comment a line | Cmd + Slash | Ctrl + Slash |
| Move a line up or down | Opt + Up / Down | Alt + Up / Down |
| Add a cursor on the next match | Cmd + D | Ctrl + D |
| Go to a symbol | Cmd + Shift + O | Ctrl + Shift + O |
| Go to a line | Ctrl + G | Ctrl + G |
| Rename a symbol | F2 | F2 |
| Format the document | Shift + Opt + F | Shift + Alt + F |
Format document looks like an exception but is not: Mac uses Shift + Opt + F, Windows Shift + Alt + F — the same keys, since Opt and Alt are the same physical key. The genuine exception is Replace, which is in the table at the top.
If you move between machines often
Three practical options, in increasing order of effort:
- Learn the differences above. There are four of them — navigation, folding, replace and the terminal split — and they come up daily.
- Use Settings Sync. VS Code syncs keybindings across machines, so a custom binding you set on one follows you to the other.
- Normalize the odd ones yourself. In the Keyboard Shortcuts editor, rebind navigate back and forward to the same keys on both platforms — most people pick Ctrl + Minus everywhere, or Alt + arrows everywhere.
Option 3 is tempting, but it only works if every machine you use is yours. On a shared or work-managed machine, you will be back to the defaults — which is the argument for simply learning them.
Why these are worth memorizing at all
Keyboard work is fast because it is automatic, and automatic means your fingers do not stop to check. A shortcut you have to think about is barely quicker than the menu.
That is exactly why the mismatched four hurt more than their number suggests: they interrupt the flow, and interruptions are what you were trying to remove. Learn them once, deliberately, and the rest of the mapping takes care of itself.