Visual Studio Code Remote - WSL
Note: You need Visual Studio Code Insiders to use this extension!
The Remote - WSL extension extension lets you use the Windows Subsystem for Linux (WSL) as your full-time development environment right from VS Code. This new, optimized support lets you:
- Use Windows to develop in a Linux based environment, using Linux specific toolchains and utilities.
- Edit files located in WSL or the mounted Windows filesystem (e.g.
- Run and debug your Linux based applications on Windows, in VS Code.
Remote - WSL runs commands and extensions directly in WSL so you don't have to worry about pathing issues, binary compatibility, or other cross-OS challenges. You're able to use VS Code in WSL just as you would from Windows.
Install VS Code - Insiders and this extension.
Install the Windows Subsystem for Linux along with your preferred Linux distribution.
Note: VS Code will use your default distro, but you can use
wslconfig.exe to change your default as needed.
Consider disabling automatic line ending conversion for Git on the Windows side by using a command prompt to run:
git config --global core.autocrlf false If left enabled, this setting can cause files that you have not edited to appear modified due to line ending differences. See tips and tricks for details.
Check out the quick start in our documentation to get going.
Another way to learn what you can do with the extension is to browse the commands it provides. Press
F1 to bring up the Command Palette and type in
Remote-WSL for a full list.
You can also click on the Remote "Quick Access" status bar item in the lower left corner to get a list of the most common commands.
For more information, please see the extension documentation.
Questions, Feedback, Contributing
Have a question or feedback?
Or connect with the community...
Visual Studio Code Remote - WSL and related extensions collect telemetry data to help us build a better experience working remotely from VS Code. We only collect data on which commands are executed. We do not collect any information about image names, paths, etc. The extension respects the
telemetry.enableTelemetry setting which you can learn more about in the Visual Studio Code FAQ.
By downloading and using the Visual Studio Remote - WSL extension and its related components, you agree to the product license terms and privacy statement.