Get Started with VS Code
This guide will walk you through installing VS Code, opening your first project, and using the essential features you’ll need every day.Download and Install
Download VS Code for your platform from code.visualstudio.com.
- Windows
- macOS
- Linux
- Download the Windows installer (.exe)
- Run the installer
- Follow the installation wizard
- Launch VS Code from the Start menu
For detailed installation instructions, see the Installation Guide.
Open a Project
Start working with your code by opening a folder or file.Open a folder:
- Click File > Open Folder (or
Ctrl+K Ctrl+Oon Windows/Linux,Cmd+K Cmd+Oon macOS) - Select your project folder
- VS Code will load your project and show the file explorer on the left
- Click File > Open File (or
Ctrl+O/Cmd+O) - Select any file to start editing
Edit Your Code
VS Code provides powerful editing features out of the box.IntelliSense:
- Start typing to see smart code completions
- Press
Ctrl+Spaceto trigger IntelliSense manually - Get inline documentation for functions and methods
Ctrl+P/Cmd+P- Quick Open: Jump to any fileCtrl+Shift+O/Cmd+Shift+O- Go to Symbol: Navigate within a fileF12- Go to Definition: Jump to where something is definedShift+F12- Find All References: See all uses of a symbol
Alt+Click/Option+Click- Add cursor at clicked positionCtrl+Alt+Up/Down/Cmd+Option+Up/Down- Add cursor above/belowCtrl+D/Cmd+D- Select next occurrence
Use the Integrated Terminal
Access your command line without leaving the editor.
- Press
Ctrl+`or click Terminal > New Terminal - Run any command in your project directory
- Create multiple terminals with the + button
- Split terminals with the split icon
Run and Debug
Debug your code with breakpoints and an interactive debugger.Quick Start:
- Open a file you want to debug
- Click in the left margin to set a breakpoint (red dot appears)
- Press
F5to start debugging - VS Code will prompt you to select a debug configuration
F5- Continue / StartF10- Step OverF11- Step IntoShift+F11- Step OutShift+F5- Stop
For Node.js projects, VS Code can debug without any configuration. For other languages, you may need to install an extension.
Install Extensions
Extend VS Code with language support, themes, and tools.
- Click the Extensions icon in the sidebar (or press
Ctrl+Shift+X/Cmd+Shift+X) - Search for the extension you need
- Click Install
- Python - Rich Python language support
- ESLint - JavaScript and TypeScript linting
- Prettier - Code formatter
- GitLens - Supercharge Git capabilities
- Live Share - Real-time collaborative editing
Essential Keyboard Shortcuts
Master these shortcuts to boost your productivity:File Navigation
Ctrl/Cmd+P- Quick OpenCtrl/Cmd+Tab- Switch between open filesCtrl/Cmd+W- Close fileCtrl/Cmd+Shift+T- Reopen closed file
Editing
Ctrl/Cmd+D- Select next occurrenceCtrl/Cmd+/- Toggle commentAlt/Option+Up/Down- Move line up/downShift+Alt/Option+Up/Down- Copy line up/down
Search & Replace
Ctrl/Cmd+F- Find in fileCtrl/Cmd+H- Replace in fileCtrl/Cmd+Shift+F- Find in filesCtrl/Cmd+Shift+H- Replace in files
View
Ctrl/Cmd+B- Toggle sidebarCtrl/Cmd+`- Toggle terminalCtrl/Cmd+Shift+E- ExplorerCtrl/Cmd+Shift+D- Debug
Quick Tips
Command Palette
Command Palette
Press
Ctrl+Shift+P / Cmd+Shift+P to open the Command Palette. This gives you access to all VS Code commands. Try typing:- “Format Document” - Format your code
- “Change Language Mode” - Change file language
- “Preferences: Color Theme” - Switch themes
Settings
Settings
Open settings with
Ctrl+, / Cmd+,. You can:- Search for any setting
- Customize editor behavior
- Configure language-specific settings
- Sync settings across devices
Git Integration
Git Integration
VS Code has built-in Git support:
- Click the Source Control icon (or press
Ctrl/Cmd+Shift+G) - Stage changes by clicking the + icon
- Write a commit message and press
Ctrl/Cmd+Enter - Push/pull with the … menu
Side by Side Editing
Side by Side Editing
- Drag a file from the Explorer to split the editor
- Or right-click a file and select “Open to the Side”
- Use
Ctrl/Cmd+\to split the active editor - Press
Ctrl/Cmd+1/2/3to focus different editor groups
Example Workflow
Here’s a complete example of opening a Node.js project and running it:Next Steps
Now that you’re familiar with the basics, explore more advanced features:Installation Options
Learn about different installation methods and options
Architecture
Understand how VS Code is built
Contributing
Contribute to the VS Code project
Build from Source
Build and debug VS Code itself
Need help? Visit Stack Overflow or check out the GitHub issues.