Installing Visual Studio Code
Visual Studio Code, also known as “VSCode”, is a widely-used open-source program specifically designed to assist with software development. This document explains how to download and install VSCode on your computer.
To proceed, you should have access to a laptop or desktop computer. Tablet and phone devices are not appropriate for software development. If you do not have a laptop or desktop computer, you may instead use one of our lab computers, all of which come with VSCode preinstalled.
The procedure for installing VSCode varies depending on your operating system. Follow the appropriate instructions below.
- I have a macOS computer.
- I have a Windows computer.
- I have a Linux computer.
- I have a FreeBSD computer.
Installing VSCode on a macOS computer
-
In your web browser (e.g., Safari), navigate to the VSCode download page.

- Click on the button titled “Download Mac Universal”.
-
You may be prompted to allow the download. If you are, click “Allow.”

- You will be redirected to a “Getting Started” page. You can close this page, since we will explain what to do next.
- Look in your
Downloadsfolder for a file calledVSCode-darwin-universal.zip. - Double-click on that file. This will “decompress” the ZIP archive and extract its contents into the current folder. Once that’s done, you should see an application file called
Visual Studio Code. -
Drag this file into the
Applicationsfolder on your computer. If you can’t find yourApplicationsfolder, click on the little macOS smiley face
and then press ⌘-SHIFT-G and type
/Applicationsand press the Enter key.
Then drag the
Visual Studio Codeicon into theApplicationsfolder. -
Start
Visual Studio Codeby double-clicking on the icon. - Once the editor is started, press ⌘-Shift-P, which opens the Command Palette. Type
shell commandand then selectShell Command: Install 'code' command in PATH. Running this command installs thecodehelper in yourTerminal. Restart yourTerminalprogram (close it and then reopen it). Thecodehelper is handy because you can run$ code .in your
Terminal, and Visual Studio will open in whatever folder you’ve navigated to in yourTerminal.
Installing VSCode on a Windows computer
-
In your web browser (e.g., Edge), navigate to the VSCode download page.

- Click on the button titled “Download for Windows”.
- You will be redirected to a “Getting Started” page. You can close this page, since we will explain what to do next.
-
Look in your
Downloadsfolder for a file named something likeVSCodeUserSetup-x64-1.71.0.exe. If you don’t know where to look for your downloads folder, you can sometimes ask your web browser. E.g., when using Edge, look for the three dots in the upper right corner of your browser window, click on them, then click onDownloads.
After that, move your mouse to the right of the
VSCodeUserSetup-x64-1.71.0.exefilename and click on the little folder icon.
This will open your
Downloadsfolder. -
Double-click on the file named
VSCodeUserSetup-x64-1.71.0.exe. This will start the VSCode installer.
- Click
I accept the agreementand clickNext. - Click
Nextagain. - Click
Install. - Start
Visual Studio Codeby double-clicking on the icon. - Click
Finish. - To start VSCode, press the Windows key and type
Visual Studio Codeand then click on the icon that appears.
Installing VSCode on a Linux computer
If you’re running Linux, we’re going to assume that you’re already an über hacker, so just follow these instructions.
Installing VSCode on a FreeBSD computer
LOL, really?
$ sudo pkg install vscode