Setting up Visual Studio Code

Getting up and running with VS Code is quick and easy. It is a small download so you can install in a matter of minutes and give VS Code a try.

Cross Platform

VS Code is a free code editor which runs on the Mac, Linux and Windows operating systems.

Follow the platform specific guides below:

VS Code is lightweight and should run on most available hardware and platform versions. You can review the System Requirements to check if your computer configuration is supported.

Additional Components

VS Code is an editor first and foremost and prides itself on a small footprint. Unlike traditional IDEs with everything but the kitchen sink, you can tune your installation to the development technologies you care about. Be sure to read the Additional Components topic after reading the platform guides to learn about customizing your VS Code installation.

Extensions

VS Code extensions let third parties add support for additional:

Extensions integrate into VS Code's UI, commands, and task running systems so you'll find it easy to work with different technologies through VS Code's shared interface. Check out the VS Code extension Marketplace to see what's available.

Proxy Server Support

Many enterprises require that their computers run behind a proxy server and don't allow direct access to the Internet. A proxy server intermediary can limit access to the VS Code Extension Marketplace and prevent installing VS Code extensions.

If you work on a machine where Internet traffic needs to go through a proxy server, then configure the proxy server in one of the following ways:

  • Set the operating system environment variables ‘http_proxy’ and ‘https_proxy’
    SET http_proxy=http://10.203.0.1:5187/
  • Configure the ‘http.proxy’ setting in your user settings (File > Preferences > User Settings or Code > Preferences > User Settings on Mac):
    "http.proxy": "http://10.203.0.1:5187/"

or for an authenticating proxy

    "http.proxy": "http://userid:password@10.203.0.1:5187/"

Additionally, use "http.proxyStrictSSL": false if your proxy server uses a self-signed certificate.

Note: VS Code supports http and https proxies, but not SOCKS proxies.

Next Steps

Once you have installed and set up VS Code, these topics will help you learn more about VS Code:

  • Additional Components - Learn how to install Git, Node.js, TypeScript and tools like Yeoman.
  • The Basics - Basic orientation around VS Code
  • Editing Evolved - Lint, IntelliSense, Lightbulbs, Peek and Go To Definition and more
  • Debugging - Debug your source code directly in the VS Code editor.

If you'd like to getting something running quickly, try the Node.js runtime walkthrough which will have you debugging a Node.js web application with VS Code in minutes.

Common Questions

Q: What are the system requirements for VS Code?

A: We have a list of System Requirements.

Q: How big is VS Code?

A: VS Code is a small download (< 100 MB) and has a disk footprint of less than 200 MB, so you can quickly install VS Code and try it out.

Q: How do I create and run a new project?

A: VS Code doesn't include a traditional File > New Project dialog or pre-installed project templates. You'll need to add additional components and scaffolders depending on your development interests. With scaffolding tools like Yeoman and the multitude of modules available through the NPM package manager, you're sure to find appropriate templates and tools to create your projects.

Q: How do I know which version I'm running?

A: On Linux and Windows, choose Help > About. On Mac, use Code > About Visual Studio Code.

Q: Why is VS Code saying my installation is corrupt?

A: VS Code has detected that some installation files have been modified, perhaps by an extension. Reinstalling VS Code will replace the affected files. See our FAQ topic for more details.