The Remote - WSL recommender extension adds commands to open a folder or workspace located in the Windows Subsystem for Linux. It will help installing the Windows Subsystem for Linux and the Remote WSL extension. This extension is bundled with Visual Studio Code. It can be disabled but not uninstalled. To get started with using WSL in VS Code, you'll need to download the Remote - WSL extension from the Extension Marketplace. You'll also need WSL and a Linux distribution installed. We recommend using WSL 2, which is the newest version of WSL, as you will benefit from significant performance advantages over WSL 1. Check out Remote - WSL in action.

1. Visual Studio Code Vs Visual Studio
2. Visual Studio Code Wsl Debug
3. Visual Studio Code Wsl Bash
4. Visual Studio Code Wallpaper

Introduction

In 2016, Microsoft launched Windows Subsystem for Linux (WSL) which brought robust unix functionality to Windows.In May 2019, Microsoft announced the release of WSL 2 which includes an updated architecture that improvedmany aspects of WSL - especially file system performance. I have been following WSL for a while butnow that WSL 2 is nearing general release, I decided to install it and try it out. In the few days Ihave been using it, I have really enjoyed the experience. The combo of using Windows 10 and afull Linux distro like Ubuntu is a really powerful development solution that works surprisingly well.

The rest of this article will discuss:

The final useful component is Visual Studio Code and some helpful extensions. I recommend that you install Visual Studio Code in your windows environment. In order to get the maximum usefulness out of this setup, you need to install a couple of extensions: Remote - WSL. When using a remote connection, Visual Studio builds C Linux projects on the remote machine. It doesn't matter if it's a physical machine, a VM in the cloud, or WSL. To build the project, Visual Studio copies the source code to your remote Linux computer. Then, the code gets compiled based on Visual Studio.

• What is WSL and why you may want to install and use it on your system?
• Instructions for installing WSL 2 and some helper apps to make development more streamlined.
• How to use this new capability to work effectively with python in a combined Windows and Linux environment.

What is WSL?

One of the biggest issues I have had with Windows in the past is that working from the command linewas painful - at best. The old Windows command prompt was no match for the power available with a simplebash shell and the full suite of unix commands. WSL fixes this in many ways. With WSL, you can install a real Linuxdistribution on your Windows system and run it at close to bare metal speeds. You can get the best ofboth worlds - full unix support in parallel with MS Office and other Windows productivity tools not available on Linux.

The concept may be a little tough to grasp at first. Here is a screenshot to bring it into a little more perspective:

In this screenshot, I am running a full version of Ubuntu 18.04 on Windows alongside Excel and Word.It all runs at very acceptable speeds on my laptop.

There have been virtualization options such as VMWare and VirtualBox for a while. The main advantage of WSL 2 is theefficient use of system resources. Microsoft accomplishes this by running a very minimal subset of Hyper-V features andonly using minimal resources when not running. With this architecture you can spin up your virtual Linux imagein a second or so and get started with your Linux environment in a seamless manner.

The other benefit of this arrangement is that you can easily copy files between the virtual environment and your baseWindows system. There are also some cool tricks to seamlessly use Visual Studio Code and Windows Explorerto bridge the gap between the two environments. In practice, it works very well.

I will go through some additional examples later in this article and highlight how to do python development in thevarious environments.

Setting Up WSL 2

I highly recommend using WSL 2 due to the speed improvements with the file system. As of this writing,these instructions are the high level process I used to get it installed on my version of Windows 10 Pro. I recommendchecking out the official Windows documentation for the latest instructions. I also found this article andthe official Ubuntu WSL page very useful for getting everything set up.

I will apologize in advance because this article has a lot of images and is pretty long. However, I wanted to developa fairly complete guide to bring together many ideas into one place. I hope you find it useful.

With that caveat out of the way, let’s get started.

Before you start, make sure you have administrator access on your system.

In addition, you need a Windows 10 Version of at least build 18917. I am using Windows Pro but I believethe Home edition will work as well.

If these are new settings for your system, make sure all the updates are applied before proceeding.

Now that the foundation is setup, you need to enable the Windows Subsystem for Linux andVirtual Machine Platform using these PowerShell commands:

Check the settings here:

You should restart to make sure the install is complete.

Now that the subsystem is installed, you need to install your preferred Linux distribution from the Microsoft Store.I have chosen to use Ubuntu. There are a few tweaks to this Ubuntu distro to make this combo work better soI recommend Ubuntu as the first distribution to start. A benefit is that once you get Ubuntu working you caninstall other distributions side by side and experiment with the one that works best for you.

The install should not take long. Once it is done, you should see an Ubuntu item on your Windows start menu.Go ahead and click it. You will get a message that the install make take a few minutes:

Then configure your username and password:

It’s always a good idea to update your Linux environment using sudo:

As you can see, this is just like the normal Ubuntu upgrade process but on your Windows system.

Go ahead and try some of your favorite commands and watch them work. Pretty cool.

The final step is to use the Windows wsl commands to enable WSL 2 for this virtual environment.You need to invoke the wsl commands from PowerShell as an administrator:

The wsl command is used to manage the different environments installed on your system.Use the command wsl -l -v to see what you have installed:

As you can see from the output, the Ubuntu-18.04 version is still at Version 1 of WSL.We want to upgrade, so use the command, wsl --set-version Ubuntu-18.04 2

Behind the scenes, this process is upgrading the environment while preserving all the existing configurations.It may take a couple of minutes for the upgrade to complete. If you are interested, this link providessome more detail on the differences between WSL 1 and 2.

When you are done, use wsl -l -v to verify that both are running Version 2.

While you are at it, you should probably use this command to set WSL to use version 2as the default for all new installs - wsl --set-default-version 2

Note, depending on when you install this, you could get a message that says “WSL2 requiresand update to its kernel component.” If you see this, reference the info in this MS blog post.

At this point, we have WSL version 2 up and running. Before we go into using it with python,I want to install a couple of additional components to make the development process easier.

Helper Apps

Windows Terminal

One of the problems with the default Windows environment is that there is not a good Terminalapplication. As I mentioned in the beginning of this post, working from the command line in Linuxhas been so much more useful than on Windows. Fortunately, Microsoft has been developinga new Windows Terminal that works really well with WSL and the other consoles. If you are interested inlearning about all the differences, I highly recommend this blog post for more detail.

The bottom line is that I recommend installing the Windows Terminal from the Microsoft Store. Iwill be using it for the rest of the command line examples:

Windows Terminal is very configurable and you can trick it out quite a bit. In the interest of keeping thispost manageable, I’ll refer you to another post that has some good details and links.

I have configured my terminal to launch a couple of different shells. I found the process of editing andconfiguring much simpler than the steps I have to do to setup a Windows Shortcut to launch conda.

If you want to review my profile.json file, I have placed a copy on github.I included commands to launch miniconda and customized some aspects of the prompts.Feel free to use this as a reference but you will need to customize it to workfor your system. If you have favorite tips and tricks, include them in the comments.

You will need to create your own GUIDs for the different sections of the profile.One option is to use python.

One final item you should consider is installing the Cascadia Fonts for a nicer looking Terminal experience.

After configuring, I have a single place to launch all the various shells and environments I might needboth in Linux and Windows:

Miniconda

As you can see from this screen, I have also installed Miniconda on my system. In a fun twist, I installeda version on the Ubuntu image as well as on Windows. I will not go into the process for installingbut I do encourage you to install it on your system in your Windows and WSL environments. This will be thedefault python environment setup I use.

VS Code

The final useful component is Visual Studio Code and some helpful extensions. I recommendthat you install Visual Studio Code in your windows environment.

In order to get the maximum usefulness out of this setup, you need to install a couple of extensions:

You will likely want to customize other aspects with themes and icons which I encourage you to do. The above mentionedextensions are the important ones for working with WSL and conda environments on your local Windows and Ubuntu environments.

Working Across environments

Accessing files

That was a lot of setup! Now what?

You should be able to launch your Ubuntu environment or Windows environment and work with Python like you normally would.

Here is a screenshot showing one terminal with tabs running Ubuntu and PowerShelland another one running conda on the Windows system:

This in an of itself is pretty useful but the real power is the way you can interactacross WSL and native Windows.

For instance, if you type explorer.exe . in your Ubuntu environment, windowswill launch the Explorer and show the current directory in the WSL environment:

Now you have a Windows Explorer view of the files in that Ubuntu WSL environment.

You can also access this environment directly in Explorer by typingthe network path wsl$Ubuntuhomechris

This cross-environment “magic” is supported by the 9P protocol file server which you can see referencedvia the mount command in the screen shot above. Microsoft has a nice write up on their blogwith some more details about how this works.

Visual Studio Code

There is another handy tricky for working across environments. You can use the WSLVisual Studio Code plugin to access the WSL file system from your VS Code install on Windows.

If you execute the command code . in your Ubuntu environment, Windowswill Launch VS Code and connect to the files within WSL. You can edit those filesusing all the normal VS Code functionality and all changes are saved within the WSL environment.You can see the indicator in the bottom left that lets you know you’re interacting with WSLand not the standard Windows system.

You can also launch VS Code in Windows and access all your running WSL environments through the commandpalette. Press Ctrl + Shift + P then type Remote-WSL to see the options.

If you have more than one WSL environment setup, then you can select the appropriate one as well.

VS Code then ensures that you are editing files in the WSL environment. For instance,When you open a file, you will only see the WSL file system:

One minor surprise I encountered is that you need to make sure any VS Code plugins you want to use in WSLare installed within the WSL environment. For instance, if you look at this screenshot, you can seehow some of the plugins are installed on the local Windows environment but you need to also ensure theyare installed on the WSL environment as well.

Fortunately, the installation is pretty simple. In fact,VS Code prompts you with a button that says “Install in WSL: Ubuntu.” The install process is simple butit is an implementation detail to keep in mind.

It is a bit crazy to think about how this works but the implementation is very seamless and in my experienceyou get used to it pretty quickly.

Jupyter Notebooks

Another method to work across environments is using the network. In researching this article,I found many comments that accessing localhost did not work in some of the older versions of WSL.I did not have any problems getting localhost to work when using Pelican or Jupyter Notebooks.I get the sense that this is an active area of focus for the developers so keep this in mind as you experiment onyour own.

The one option I do recommend you use is the --no-browser switch to avoid a warning messagewhen launching a Jupyter notebook. In the example below, I’m running Jupyter in Ubuntu but viewing iton my local Edge browser.

Also, it’s helpful to remember that if you want to copy data from the terminal use Ctrl + Shift + Cto copy and Ctrl + Shift + V to paste. You will likely need this to copy the token and authenticatewith the Jupyter process.

Directly running apps

The wsl command is a powerful tool for operating on WSL environments. One of itscapabilities is that it can run an executable directly from the Linux environment.For example, we can run the fortune command that is installed in our Ubuntu environment.

What about running Graphical Apps?

For the most part, I’ve been using the Windows-native apps for graphical applications.Between MS Office Apps, Chrome and VS Code I have most use cases covered. If I want to useapps like Gimp or Inkscape, I can use the Windows versions.

However, I have found a couple of niche apps that did not have a good equivalent in Windows. Onesimple app I use is Trimage to compress images.

I can install it in Ubuntu, but when I try to execute it, I get an error message,trimage.py: cannot connect to X server

The fix for this is to install an X Server on Windows. There are several options includinga pay version called X410. I elected to use VcXsrv (oh sourceforge, such memories).

Be forewarned it is definitely not a Native Win 10 app so this is all going to look a bit ugly.There are likely ways to make it look better but I have not investigated because this isan approach of last resort for a handful of apps. I’m sharing for completeness.

Anyway, Install VcXsrv and run it:

I needed to Disable Access Control:

Once it is launched, it will sit in the system tray and listen for connections.

In order to configure your Ubuntu environment, make sure these two lines are in your .bashrcfile. After making the changes, restart the shell:

If all is configured correctly, you should see Trimage:

It worked just fine for compressing the images in this post.

If you really feel the need to run a more full-fledged graphical environment, you can installa light-weight desktop environment like xfce and launch it as well Here is how to install it:

Here is a busy screen shot showing all of this working together:

Visual Studio Code Vs Visual Studio

The image shows:

Visual Studio Code Wsl Debug

• VS Code, editing files in the WSL environment
• A full xfce desktop running on WSL being displayed in the local Windows X server
• The WSL environment serving up the pelican blog

Workflow

Now that you have all these options for python development on a single machine, you need to decide how best toconfigure for your needs. I am still working through my process but here is what I’m doing right now:

• Chrome on Win 10: General web browsing, email, Jupyter notebooks
• Visual Studio Code on Win 10: Text and python file editing
• Visual Studio on Win 10 connected through WSL: Write ReStructured Text articles for blog
• Ubuntu on WSL: Maintain and develop content on Pelican blog
• Ubuntu on WSL: Command line tools as needed
• python on WSL: Blog content and general development/experimentation
• python on Win 10: Development when working on Windows specific tasks (Excel, Word, etc)

Visual Studio Code Wsl Bash

The key point is that even though the WSL and Windows environments can “talk” to each other, there does needto be some segregation of responsibilities. For instance, when using git in WSL, it is recommended thatyou operate on the files in the WSL environment. The same goes for Windows - don’t try to run Windows executablesdirectly from the WSL file system.

Finally, I still recommend that you use conda environments to keep your python environments clean. I have chosento have a conda environment on Ubuntu and one on Windows so that I can make sure blog posts work appropriatelyacross Windows and Linux environments.

Troubleshooting

The process for installing WSL continues to evolve. If you get stuck, take a look at Microsoft’stroubleshooting guide here.

Conclusion

WSL is a major step forward in making Windows a first class development platform. I have been a long-timeUbuntu user at home and Windows user at work. WSL finally gives me a platform where I can have thebest of both worlds. I get access to all the tools and flexibility of working in Ubuntu alongside thecommon MS Office tools. In addition, I am confident any commercial software I might need can be installedon this system.

I hope you find this guide useful and that it helps you build your own python development environmentfor Windows and Linux. If you have any other tips, let me know in the comments.

Updates

• 25-June-2020 Updated to remove references to the Windows insider program. This is generally available now.
• 17-August-2020 Added a note about the troubleshooting guide from MS.

Visual Studio Code Wallpaper

Comments