Visual Studio Code has a powerful command line interface that lets you control how your launch the editor. You can open or diff files, install extensions, even change the display language on startup.
Launching from the command line
You can launch VS Code from the command line to quickly open a file, folder, or project. Typically, you open VS Code within the context of a folder. We find the best way to do this is to simply type:
Tip: We have instructions for Mac users in our Setup topic that enable you to start VS Code from within a terminal. We add the VS Code executable to the
PATHenvironment variable on Windows and Linux automatically during installation.
Sometimes you will want to open or create a file. If the specified files does not exist, VS Code will create them for you:
code index.html style.css readme.md
Tip: You can have as many file names as you want separated by spaces.
Additional command line arguments
Here are optional command line arguments you can use when starting VS Code at the command line via
||Print VS Code version (e.g. 0.10.10)|
||Opens a new session of VS Code instead of restoring the previous session (default).|
||Forces opening a file or folder in the last active window.|
||When used with file:line:character?, opens a file at a specific line and optional character position. This argument is provided since some operating systems permit
|file||Name of a file to open. If the file doesn't exist, it will be created and marked as edited. You can specify multiple files by separating each file name with a space.|
|file:line:character?||Name of a file to open at the specified line and optional character position. You can specify multiple files in this manner, but you must use the
|folder||Name of a folder to open. You can specify multiple folders.|
||Open a file difference editor. Requires two file paths as arguments.|
||Set the display language (locale) for the VS Code session. Supported locales are:
||Disable all installed extensions. Extensions will still be visible in the
||List the installed extensions.|
||Install an extension. Provide the full extension name
||Uninstall an extension. Provide the full extension name
||Wait for the window to be closed before returning|
For both files and folders, you can use absolute or relative paths. Relative paths are relative to the current directory of the command prompt where you run
If you specify more than one file or folder at the command line, VS Code will open only a single instance.
Opening VS Code with URLs
In Windows and macOS, you can also open projects and files using the platform's URL handling mechanism. Use the following URL formats to:
Open a project
Open a file
Open a file to line and column
Read on to find out about: