- Visual Studio Code Tips and Tricks
- Basics
- Command line
- Status Bar
- Customization
- Extensions
- Files and Folders
- Editing Hacks
- Multi cursor selection
- Join line
- Copy line up / down
- Shrink / expand selection
- Go to Symbol in File
- Go to Symbol in Workspace
- Navigate to a specific line
- Undo cursor position
- Move line up and down
- Trim trailing whitespace
- Code formatting
- Code folding
- Select current line
- Navigate to beginning and end of file
- Open Markdown Preview
- Side by Side Markdown Edit and Preview
- IntelliSense
- Snippets
- Git integration
- Debugging
- Task Runner
- Insiders builds
Visual Studio Code Tips and Tricks
“Tips and Tricks” lets you jump right in and learn how to be productive with Visual Studio Code. You’ll become familiar with its powerful editing, code intelligence, and source code control features and learn useful keyboard shortcuts. This topic goes pretty fast and provides a broad overview, so be sure to look at the other in-depth topics in Getting Started and the User Guide to learn more.
If you don’t have Visual Studio Code installed, go to the Download page. You can find platform specific setup instructions at Running VS Code on Linux, macOS, and Windows.
Basics
Getting Started
Open the Welcome page to get started with the basics of VS Code. Help > Welcome.
Includes the Interactive Playground.
Command Palette
Access all available commands based on your current context.
Keyboard Shortcut: kb(workbench.action.showCommands)
Default keyboard shortcuts
All of the commands are in the Command Palette with the associated key binding (if it exists). If you forget a keyboard shortcut, use the Command Palette to help you out.
Keyboard Reference Sheets
Download the keyboard shortcut reference sheet for your platform (macOS, Windows, Linux).
Quick Open
Quickly open files.
Keyboard Shortcut: kb(workbench.action.quickOpen)
Tip: Type kbstyle(?)
to view help suggestions.
Navigate between recently opened files
Repeat the Quick Open keyboard shortcut to cycle quickly between recently opened files.
Open multiple files from Quick Open
You can open multiple files from Quick Open by pressing the Right arrow key. This will open the currently selected file in the background and you can continue selecting files from Quick Open.
Command line
VS Code has a powerful command line interface (CLI) to help you customize the editor launch your specific scenarios.
Make sure the VS Code binary is on your path so you can simply type ‘code’ to launch VS Code. See the platform specific setup topics if VS Code is added to your environment path during installation (Running VS Code on Linux, macOS, Windows).
# open code with current directory
code .
# open the current directory in the most recently used code window
code -r .
# create a new window
code -n
# change the language
code --locale=es
# open diff editor
code --diff <file1> <file2>
# open file at specific line and column <file:line[:character]>
code --goto package.json:10:5
# see help options
code --help
# disable all extensions
code --disable-extensions .
.vscode folder
Workspace specific files are in a .vscode
folder at the root. For example, tasks.json
for the Task Runner and launch.json
for the debugger.
Status Bar
Errors and Warnings
Keyboard Shortcut: kb(workbench.actions.view.problems)
Quickly jump to errors and warnings in the project.
Cycle through errors with kb(editor.action.marker.next)
or kb(editor.action.marker.prev)
You can filter problems by type (‘errors’, ‘warnings’) or text matching.
Change language mode
Keyboard Shortcut: kb(workbench.action.editor.changeLanguageMode)
If you want to persist the new language mode for that file type, you can use the Configure File Association for … command to associate the current file extension with an installed language.
Customization
There are many things you can do to customize VS Code.
- Change your theme
- Change your keyboard shortcuts
- Tune your settings
- Add JSON validation
- Create snippets
- Install extensions
Check out the full Settings documentation.
Change your theme
Keyboard Shortcut: kb(workbench.action.selectTheme)
You can install more themes from the extension Marketplace.
Additionally, you can install and change your File Icon themes.
Keymaps
Are you used to keyboard shortcuts from another editor? You can install a Keymap extension that brings the keyboard shortcuts from your favorite editor to VS Code. Go to Preferences > Keymap Extensions to see the current list on the Marketplace. Some of the more popular ones:
Customize your keyboard shortcuts
Keyboard Shortcut: kb(workbench.action.openGlobalKeybindings)
You can search for shortcuts and add your own keybindings to the keybindings.json
file.
See more in Key Bindings for Visual Studio Code.
Tune your settings
Open User Settings settings.json
Keyboard Shortcut: kb(workbench.action.openGlobalSettings)
Format on paste
"editor.formatOnPaste": true
Change the font size
"editor.fontSize": 18
Change the zoom level
"window.zoomLevel": 5
Font ligatures
"editor.fontFamily": "Fira Code",
"editor.fontLigatures": true
Tip: You will need to have a font installed that supports font ligatures. FiraCode is a popular font on the VS Code team.
Auto Save
"files.autoSave": "afterDelay"
You can also toggle Auto Save from the top-level menu with the File > Auto Save.
Format on save
"editor.formatOnSave": true,
Change the size of Tab characters
"editor.tabSize": 4
Spaces or Tabs
"editor.insertSpaces": true
Render whitespace
"editor.renderWhitespace": "all"
Ignore files / folders
Removes these files / folders from your editor window.
"files.exclude": {
"somefolder/": true,
"somefile": true
}
Remove these files / folders from search results.
"search.exclude": {
"someFolder/": true,
"somefile": true
}
And many, many other customizations.
Language specific settings
For those settings you only want for specific languages, you can scope the settings by the language identifier. You can find a list of commonly used language ids in the Language Identifiers reference.
"[languageid]": {
}
Tip: You can also create language specific settings with the Configure Language Specific Settings… command.
Add JSON validation
Enabled by default for many file types. Create your own schema and validation in settings.json
"json.schemas": [
{
"fileMatch": [
"/bower.json"
],
"url": "http://json.schemastore.org/bower"
}
]
or for a schema defined in your workspace
"json.schemas": [
{
"fileMatch": [
"/foo.json"
],
"url": "./myschema.json"
}
]
or a custom schema
"json.schemas": [
{
"fileMatch": [
"/.myconfig"
],
"schema": {
"type": "object",
"properties": {
"name" : {
"type": "string",
"description": "The name of the entry"
}
}
}
},
See more in the JSON documentation.
Extensions
Keyboard Shortcut: kb(workbench.view.extensions)
Find extensions
- In the VS Code Marketplace.
- Search inside VS Code in the Extensions view.
- View extension recommendations
- Community curated extension lists, such as awesome-vscode.
Install extensions
In the Extensions view, you can search via the search bar or click the More (…) button to filter and sort by install count.
Extension recommendations
In the Extensions view, click Show Recommended Extensions in the More (…) button menu.
Creating my own extension
Are you interested in creating your own extension? You can learn how to do this in the documentation, specifically check out the documentation on contribution points.
- configuration
- commands
- keybindings
- languages
- debuggers
- grammars
- themes
- snippets
- jsonValidation
Files and Folders
Integrated Terminal
Keyboard Shortcut: kb(workbench.action.terminal.toggleTerminal)
Further reading:
- Integrated Terminal documentation
- Mastering VS Code’s Terminal article
Auto Save
Open User Settings settings.json
with kb(workbench.action.openGlobalSettings)
"files.autoSave": "afterDelay"
You can also toggle Auto Save from the top-level menu with the File > Auto Save.
Toggle Sidebar
Keyboard Shortcut: kb(workbench.action.toggleSidebarVisibility)
Zen Mode
Keyboard Shortcut: kb(workbench.action.toggleZenMode)
Enter distraction free Zen mode.
Side by side editing
Keyboard Shortcut: kb(workbench.action.splitEditor)
You can also use kbstyle(Ctrl)
then click a file from the File Explorer (kbstyle(Cmd+click)
on macOS).
You can use drag and drop editors to create new editor groups and move editors between groups.
Switch between editors
Keyboard Shortcut: kb(workbench.action.focusFirstEditorGroup)
, kb(workbench.action.focusSecondEditorGroup)
, kb(workbench.action.focusThirdEditorGroup)
Move to Explorer window
Keyboard Shortcut: kb(workbench.view.explorer)
Create or open a file
Keyboard Shortcut: kbstyle(Ctrl+click)
(kbstyle(Cmd+click)
on macOS)
You can quickly open a file or image or create a new file by moving the cursor to the file link and using kbstyle(Ctrl+click)
.
Close the currently opened folder
Keyboard Shortcut: kb(workbench.action.closeActiveEditor)
Navigation history
Navigate entire history: kb(workbench.action.openNextRecentlyUsedEditorInGroup)
Navigate back: kb(workbench.action.navigateBack)
Navigate forward: kb(workbench.action.navigateForward)
Navigate to a file
Keyboard Shortcut: kb(workbench.action.quickOpen)
File associations
Create language associations for files that aren’t detected correctly. For example, many configuration files with custom file extensions are actually JSON.
"files.associations": {
".database": "json"
}
Editing Hacks
Here are a selection of common features for editing code. If the keyboard shortcuts aren’t comfortable for you, consider installing a keymap extension for your old editor.
Tip: You can see recommended keymap extensions in the Extensions view with kb(workbench.extensions.action.showRecommendedKeymapExtensions)
which filters the search to @recommended:keymaps
.
Multi cursor selection
Keyboard Shortcut: kb(editor.action.insertCursorAbove)
or kb(editor.action.insertCursorBelow)
Add more cursors to current selection.
Note: You can also change the modifier to
kbstyle(Ctrl/Cmd)
for applying multiple cursors with theeditor.multiCursorModifier
setting . See Multi-cursor Modifier for details.
Join line
Keyboard Shortcut: kb(editor.action.joinLines)
Windows / Linux: Not bound by default. Open Keyboard Shortcuts (
kb(workbench.action.openGlobalKeybindings)
) and bindeditor.action.joinLines
to a shortcut of your choice.
Copy line up / down
Keyboard Shortcut: kb(editor.action.copyLinesUpAction)
or kb(editor.action.copyLinesDownAction)
The commands Copy Line Up/Down are unbound on Linux because the VS Code default keybindings would conflict with Ubuntu keybindings, see Issue #509. You can still set the commands
editor.action.copyLinesUpAction
andeditor.action.copyLinesUpAction
to your own preferred keyboard shortcuts.
Shrink / expand selection
Keyboard Shortcut: kb(editor.action.smartSelect.shrink)
or kb(editor.action.smartSelect.grow)
You can learn more in the Basic Editing documentation.
Go to Symbol in File
Keyboard Shortcut: kb(workbench.action.gotoSymbol)
You can group the symbols by kind by adding a colon, @:
.
Go to Symbol in Workspace
Keyboard Shortcut: kb(workbench.action.showAllSymbols)
Navigate to a specific line
Keyboard Shortcut: kb(workbench.action.gotoLine)
Undo cursor position
Keyboard Shortcut: kb(cursorUndo)
Move line up and down
Keyboard Shortcut: kb(editor.action.moveLinesUpAction)
or kb(editor.action.moveLinesDownAction)
Trim trailing whitespace
Keyboard Shortcut: kb(editor.action.trimTrailingWhitespace)
Code formatting
Currently selected source code: kb(editor.action.formatSelection)
Whole document format: kb(editor.action.formatDocument)
Code folding
Keyboard Shortcut: kb(editor.fold)
and kb(editor.unfold)
Select current line
Keyboard Shortcut: kb(expandLineSelection)
Navigate to beginning and end of file
Keyboard Shortcut: kb(cursorTop)
and kb(cursorBottom)
Open Markdown Preview
In a Markdown file, use
Keyboard Shortcut: kb(markdown.showPreview)
Side by Side Markdown Edit and Preview
In a Markdown file, use
Keyboard Shortcut: kb(markdown.showPreviewToSide)
Special bonus: The preview will now sync.
IntelliSense
kb(editor.action.triggerSuggest)
to trigger the Suggestions widget.
You can view available methods, parameter hints, short documentation, etc.
Peek
Select a symbol then type kb(editor.action.peekImplementation)
. Alternatively, you can use the context menu.
Go to Definition
Select a symbol then type kb(editor.action.goToDeclaration)
. Alternatively, you can use the context menu or kbstyle(Ctrl+click)
(kbstyle(Cmd+click)
on macOS).
You can go back to your previous location with the Go > Back command or kb(workbench.action.navigateBack)
.
You can also see the type definition if you press kbstyle(Ctrl)
(kbstyle(Cmd)
on macOS) when you are hovering over the type.
Find All References
Select a symbol then type kb(editor.action.referenceSearch.trigger)
. Alternatively, you can use the context menu.
Rename Symbol
Select a symbol then type kb(editor.action.rename)
. Alternatively, you can use the context menu.
.eslintrc.json
Install the ESLint extension. Configure
your linter however you’d like. Consult the ESLint specification for details on it’s linting rules and options.
Here is configuration to use ES6.
{
"env": {
"browser": true,
"commonjs": true,
"es6": true,
"node": true
},
"parserOptions": {
"ecmaVersion": 6,
"sourceType": "module",
"ecmaFeatures": {
"jsx": true,
"classes": true,
"defaultParams": true
}
},
"rules": {
"no-const-assign": 1,
"no-extra-semi": 0,
"semi": 0,
"no-fallthrough": 0,
"no-empty": 0,
"no-mixed-spaces-and-tabs": 0,
"no-redeclare": 0,
"no-this-before-super": 1,
"no-undef": 1,
"no-unreachable": 1,
"no-use-before-define": 0,
"constructor-super": 1,
"curly": 0,
"eqeqeq": 0,
"func-names": 0,
"valid-typeof": 1
}
}
package.json
See IntelliSense for your package.json
file.
Emmet syntax
Snippets
Create custom snippets
File > Preferences > User Snippets, select the language, and create a snippet.
"create component": {
"prefix": "component",
"body": [
"class $1 extends React.Component {",
"",
"\trender() {",
"\t\treturn ($2);",
"\t}",
"",
"}"
]
},
See more details in Creating your own Snippets.
Git integration
Keyboard Shortcut: kb(workbench.view.scm)
Git integration comes with VS Code “in-the-box”. You can install other SCM provider from the extension Marketplace. This section describes the Git integration but much of the UI and gestures are shared by other SCM providers.
Diffs
From the Source Control view, select the file to diff.
Side by side
Default is side by side diff.
Inline view
Toggle inline view by clicking the More (…) button in the top right and selecting Switch to Inline View.
If you prefer the inline view, you can set "diffEditor.renderSideBySide": false
.
Review pane
Navigate through diffs with kb(editor.action.diffReview.next)
and kb(editor.action.diffReview.prev)
. This will present them in a unified patch format.
Lines can be navigated with arrow keys and pressing kbstyle(Enter)
will jump back in the diff editor and the selected line.
Edit pending changes
You can make edits directly in the pending changes of the diff view.
Branches
Easily switch between Git branches via the Status Bar.
Staging
Stage all
Hover over the number of files and click the plus button.
Stage selected
Stage a portion of a file by selecting that file (using the arrows) and then choosing Stage Selected Ranges from the Command Palette.
Undo last commit
See Git output
VS Code makes it easy to see what Git commands are actually running. This is helpful when learning Git or debugging a difficult source control issue.
Use the Toggle Output command (kb(workbench.action.output.toggleOutput)
) and select Git in the drop-down.
Gutter indicators
View diff decorations in editor. See documentation for more details.
Resolve merge conflicts
During a merge, go to the Source Control view (kb(workbench.view.scm)
) and make changes in the diff view.
Setup VS Code as default merge tool
git config --global merge.tool code
Debugging
Configure debugger
From the Command Palette (kb(workbench.action.showCommands)
) and select Debug: Open launch.json, select the environment. This will generate a launch.json
file. Works out of the box as expected for Node.js and other environments. May need some additional configuration for other languages. See documentation for more details.
Breakpoints and stepping through
Place breakpoints next to the line number. Navigate forward with the Debug widget.
Data inspection
Inspect variables in the Debug panels and in the console.
Inline values
You can set "debug.inlineValues": true
to see variable values inline in the debugger. This feature is experimental and disabled by default.
Task Runner
Auto detect tasks
Select Tasks from the top-level menu, run the command Configure Tasks…, then select the type of task you’d like to run.
This will generate a task.json
file with content like the following. See the Tasks documentation for more details.
{
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
{
"type": "npm",
"script": "install",
"group": {
"kind": "build",
"isDefault": true
}
}
]
}
There are occasionally issues with auto generation. Check out the documentation for getting things to work properly.
Run tasks from the Tasks menu
Select Tasks from the top-level menu, run the command Run Task…, and select the task you want to run. Terminate the running task by running the command Terminate Task…
Insiders builds
The Visual Studio Code team uses the Insiders version to test the latest features and bug fixes of VS Code. You can also use the Insiders version by downloading here.
- For Early Adopters - Insiders has the most recent code changes for users and extension authors to try out.
- Frequent Builds - New builds everyday with the latest bug fixes and features.
- Side-by-side install - Insiders installs next to the Stable build allowing you to use either independently.