Interested in learning Vue.js? Get my free ebook at vuehandbook.com Editors are a strange beast. Some people defend their editor choice strenuously. In the Unix world you have those vs “wars”, and I kind of imagine so much time is spend debating the advantages of one versus another. Emacs vi why I used tons of editors and IDEs in the past few years. I can remember TextMate, TextWrangler, Espresso, BBEdit, XCode, Coda, Brackets, Sublime Text, Atom, vim, PHPStorm. The difference between an IDE and an editor is mostly in the feature set, and complexity. I largely prefer an editor over an IDE, as it’s faster and gets less in the way. In the last 12 months I’ve been using VS Code, the Open Source editor from Microsoft, and it’s quickly become my favorite editor ever. Should I switch to VS Code? And why? If you’re looking for suggestions for whether to use it or not, let me say , you should switch to it from whatever other editor you are using now. yes This editor builds on top of decades of editor experience from Microsoft. The code of the editor is completely Open Source, and there’s no payment required to use it. It uses as its base, which enables it to be cross platform and work on Mac, Windows and Linux. It’s built using , and you can extend it using (which makes it a win for all us JavaScript developers). Electron Node.js JavaScript It’s , easily the fastest editor I’ve used after Sublime Text. fast It has won the enthusiasm of the community: there are thousands of , some official, and some made by the community, and it’s . extensions winning surveys Microsoft releases an update every month. Frequent updates foster innovation and Microsoft is listening to its users, while keeping the platform as stable as possible (I should say I never had an issue with VS Code in 1 year of using it every day almost all day). Getting started The home page of Visual Studio Code on the internet is . https://code.visualstudio.com/ Go to that site to download the latest stable release of the editor. The installation process depends on the platform, and you should be used to it. When you start the editor for the first time you will see the welcome screen: There is a toolbar on the left with 5 icons. That gives access to: The File Explorer Search Source Control The Debugger The Extensions Explorer Let’s start the exploration with the explorer (pun intended). Press the “Open Folder” button in the sidebar, or the link in the Welcome page. Both will trigger the file picker view. Open folder... Choose one folder where you have source code, or even just text files, and open it. VS Code will show that folder content in your view: On the right, the empty view shows some commands to perform some quick operations, and their keyboard shortcut. If you select a file on the left, that file will open on the main panel: and if you start editing it, notice a dot will appear next to the file name in the tab, and in the sidebar as well: Pressing will show you a quick file picker to easily move in files on large projects: CMD+P You can hide the sidebar that hosts the file using the shortcut . CMD+B Note: I’m using the Mac keyboard shortcuts. Most of the times, on Windows and Linux you just change CMT to CTRL and it works, but not always. Print your keyboard shortcuts reference . Search The second icon in the toolbar is “Search”. Clicking it shows the search interface: You can click the icons to make the search case sensitive, to match whole words (not substrings), and to use a regular expression for the search string. To perform the search, press . enter Clicking the ▷ symbol on the left enables the search and replace tool. Clicking the 3 dots shows a panel that lets you just include some specific kind of files, and exclude other files: Source Control The Source Control tab is enabled by clicking the third icon in the toolbar. VS Code comes with Git support out of the box. In this case the folder we opened does not have source control initialized. Clicking the first icon on top, with the Git logo, allows us to initialize the Git repository: The beside each file means that it’s been updated since the last commit (since we never did a commit in the first place, all files are updated). U Create the first commit by writing a text message and pressing , or clicking the ✔︎ icon on top. Cmd-Enter I usually set this to automatically stage the changes when I commit them. The 3 dots icon, when clicked, offers lots of options for interacting with Git: Debugger The fourth icon in the toolbar opens the JavaScript debugger. This deserves an article on its own. In the meantime . check out the official docs Extensions The fifth icon brings us to extensions. Extensions are one killer feature of VS Code. They can provide so much value that you’ll surely end up using tons of them. I have lots of extensions installed. One thing to remember is that every extension you install is going to impact (more or less) the performance of your editor. You can disable an extension you install, and enable only when you need it. You can also disable an extension for a specific workspace (we’ll talk about work workspaces later). For example, you don’t want to enable the JavaScript extensions in a Go project. There is a list of recommended extensions, which include all the most popular tools. Since I edit lots of markdown files for my blog, VS Code suggests me the extension, which provides linting and syntax checking for Markdown files. markdownlint As an example, let’s install it. First, I inspect the number of views. It’s 1.2M, so many! And the reviews are positive (4.5⁄5). Clicking the extension name opens the details on the right. Pressing the green Install button starts the installation process, which is straightforward. It does everything for you, and you just need to click the “Reload” button to activate it, which basically reboots the editor window. Done! Let’s test it by creating a markdown file with an error, like a missing attribute on an image. It successfully tells us so: alt Down below I introduce some popular extensions you don’t want to miss, and the ones I use the most. The Terminal VS Code has an integrated terminal. You can activate it from the menu , or using ` and it will open with your default shell. View ➤ Integrated Terminal CMD+\ This is very convenient because in modern web development you almost always have some or process running in the background. npm yarn You can create more than one terminal tab, and show them one next to the other, and also stack them to the right rather than in the bottom of the window: The Command Palette The Command Palette is a very powerful tool. You enable it by clicking , or using View ➤ Command Palette CMD+SHIFT+P A modal window will appear at the top, offering you various options, depending on which plugins you have installed, and which commands you used last. Common operations I perform are: Extensions: Install Extensions to change the color theme (I sometimes change from night to day) Preferences: Color Theme , which formats code automatically Format Document , which is provided by Code Runner, and executes the highlighted lines of JavaScript Run Code you can activate any of those by starting typing, and the autocomplete functionality will show you the one you want. Remember when you typed to see the list of files, before? That’s a shortcut to a specific feature of the Command Palette. There are others: CMD+P shows you the active files Ctrl-Shift-Tab opens the command palette to let you enter a line number to go to Ctrl-G shows the list of symbols found in the current file CMD+SHIFT+O What symbols depends on the file type. In JavaScript, those might be classes or functions. In Markdown, section titles. are Themes You can switch the color theme used by clicking + , or by invoking the command. CMD-k CMD-t Preferences: Color Theme This will show you the list of themes installed: you can click one, or move with the keyboard, and VS Code will show you a preview. Click enter to apply the theme: Themes are just extensions. You can install new themes by going to the extensions manager. Probably the best thing for discoverability is to use . the marketplace website My favorite theme is , which provides a great style for any time of the day, night, morning/evenings and afternoon. Ayu Customization Theme is just one customization you can make. The sidebar icons that are assigned to a file are also a big part of a nice user experience. You can change those by going to . Ayu comes with its own icons theme, which perfectly matches the theme colors: Preferences ➤ File Icon Theme All those customizations we made so far, the theme and the icon theme, are saved to the user preferences. Go to (also reachable via ) to see them: Preferences ➤ Settings CMD-, The view shows the default settings on the left, for an easy reference, and the overridden settings on the right. You can see the name of the theme and the icon theme we set up, in and . workbench.colorTheme workbench.iconTheme I zoomed in using , and this setting was saved as well to , so the next time VS Code starts up, it remembers my choice for zooming. CMD-+ window.zoomLevel You can decide to apply some setting globally, in , or relative to a workspace, in . User Settings Workspace settings Most of the times those settings are automatically added by extensions or by the VS Code itself, but in some cases you’ll directly edit them in this place. Nice configuration options Some nice configuration options I set in my code: Remove the minimap, which is shown at the right of the editor "editor.minimap.enabled": false Stop asking me for confirmation when I want to remove a file (I have source control!) "explorer.confirmDelete": false Disable the confirmation for drag and drop "explorer.confirmDragAndDrop": false Format the code automatically when I save it "editor.formatOnSave": true Format the code automatically when I paste it in my code "editor.formatOnPaste": true Enable formatting for JavaScript code "javascript.format.enable": true Trim whitespace in files "files.trimTrailingWhitespace": true When clicking the Alt key and clicking with the mouse, I can select multiple lines "editor.multiCursorModifier": "alt" Adapt to the file indentation, useful when editing other people code "editor.detectIndentation": true Show the code suggestion immediately, not after some seconds "editor.quickSuggestionsDelay": 0 The best font for coding I like . It’s free, and has some very nice programming ligatures, which transform common constructs like and to nicer symbols: Fira Code !== => Enable it by installing the font and adding this to your configuration: "editor.fontFamily": "Fira Code", "editor.fontLigatures": true` Workspaces All User settings can be overridden in Workspace settings. They take precedence. They are useful for example when you use a project that has linting rules different from all the other projects you use, and you don’t want to edit your favorite settings just for it. You create a workspace from an existing project by clicking the menu. File ➤ Save Workspace as... The currently opened folder will be enabled as the workspace main folder. The next time you open VS code, or you switch project, instead of opening a folder, you open a workspace, and that will automatically open the folder containing your code, and it will remember all the settings you set specific to that workspace. In addition to having workspace-level settings, you can disable extensions for a specific workspace. You can just work with folders until you have a specific reason for wanting a workspace. One good reason is the ability to have multiple, separate root folders. You can use the to add a new root folder, which can be located anywhere in the filesystem, but will be shown along with the other existing folder you had. File ➤ Add Folder to Workspace Editing IntelliSense When you edit in one of the supported languages (JavaScript, JSON, HTML, CSS, Less, Sass, C# and TypeScript) VS Code has IntelliSense, a technology that hints at autocompletion of functions and parameters, as you type them. Code Formatting Two handy commands ( and ) are available on the Commands Palette to autoformat the code. VS Code by defaults supports automatic formatting for HTML, JavaScript, TypeScript and JSON. Format Document Format Selection Errors and warnings When you open a file you will see on the right a bar with some colors. Those colors indicate some issues in your code. For example here’s what I see right now: Those are al warnings or errors. You can try to find them in the code, where you see pieces underlined in red, or you can also press (or choose ) CMD-Shift-M View ➤ Problems Keyboard shortcuts I showed you a lot of keyboard shortcuts up to now. It’s starting to get complicated to remember them all, but they are a nice productivity aid. I suggest to print the official shortcuts cheat sheet, for , and . Mac Linux Windows Keymaps If you’re used to keyboard shortcuts from other editors, maybe because you worked with one editor for a long time, you can use a keymap. The VS Code team provides keymaps for the most popular editors out of the box: vim, Sublime Text, Atom, IntelliJ, Eclipse and more. They are available as plugins. By opening the menu. Preferences ➤ Keymaps Extensions Code snippets Snippets are very cool. For every language you might be developing in, there are extensions that provide ready-made snippets for you to use. For JavaScript/React, one popular one is VS Code ES7 React/Redux/React-Native/JS snippets You just type , press TAB and this appears in your editor: rfe import React from 'react'const $1 = props => { return <div>$0</div>}export default $1 there are lots of these shortcuts, and they save a lot of time. Not just from typing, but also from looking up the correct syntax. You can also define your own snippets. Click and follow the instructions to create your own snippets file. Preferences ➤ User Snippets Extensions showcase : visualize who made the last change to a line of your code, and when this happened GitLens visualize and search the Git history Git History lets you see and edit CSS definitions by inspecting the class of an HTML element. Very handy. CSS Peek lets you run bits of code that you select in the editor, and much more. Supports lots of languages. Code Runner allows you to debug a JavaScript code running in the browser using the VS code debugger. Debugger for Chrome handy for visualizing brackets endings in your code. Bracket Pair Colorizer colors the indentation levels of your code. Indent-Rainbow check my Prettier Prettier guide check my ESLint ESLint guide improved autocompletion for CSS based on your workspace definitions IntelliSense for CSS enables utility functions from the command palette npm npm automatically close HTML/JSX/* tags Auto Close Tag The VS Code CLI command When you install VS Code, the command is available globally in your command line. code This is very useful to start the editor and open a new window with the content of the current folder, with . code . will create a new window. code -n A useful thing that’s not always knows is that VS Code can quickly show the diff between two files, with . code --diff file1.js file2.js Interested in learning Vue.js? Get my free ebook at vuehandbook.com Originally published at flaviocopes.com .
