For a few years now (well, it feels like many years), I've been singing the praises of WSL - Windows Subsystem for Linux. It's one of the biggest reasons I switched to Windows after years on OSX. (Not the only reason, but you don't want to hear me rant about Apple.) The only real issue with WSL was the slowness of file operations. There were technical reasons for this of course, but honestly it only really bugged me when doing npm operations.
As you know, running
npm i something tends to fetch an incredible amount of files. In my completely unscientific testing, I'd say these operations were 2-5X slower in WSL than in the native Windows shell. Another command that would be slow at times was
git status. Outside of that though it was just fine. I'm no command line jedi but I definitely preferred the Unix shell to cmd.exe or Powershell.
A while back Microsoft announced a major rework of WSL. You can look up the technical details if you want, but after going through the process of upgrading to WSL2 on two machines now, I can say that I'm absolutely blown away by the speed improvements.
With that in mind, I wanted to share a few tips on the process and how it impacted my development. This isn't meant to be an introduction to WSL or a complete guide to using it, just what I encountered and what I changed in the process. I had some great help from Microsoft folks on Twitter so I definitely encourage you reaching out if you run into issues as well.
Alright, so start off by going to the WSL2 Install guide. You'll note that you need Windows version 18917 or higher in order to use WSL2. I'm currently on the Insider Slow Ring at version 19041.208. Insider Slow Ring gives you earlier access to new Windows features and at least for me has been really stable. If you don't know what version of Windows you're on, just run winver.exe, which by the way you can do from WSL.
As part of the install process, they document how to check your WSL installs. You can do this by running
wsl -l -v:
To update, you simply run
wsl --set-version Ubuntu 2 where
Ubuntu is the name of your distro and may be different. You may get prompted to install stuff first:
I followed the directions there which basically had you copy and paste stuff into Powershell (be sure to run Powershell as an Administrator). I then ran the command again and got:
Once again, follow the link, do the install, and you should be good. One one machine I had to tweak my BIOS, but on the other the install was good enough.
Now if you run the update command again, you should hopefully get:
On my fancy new laptop, this was rather quick, unfortunately I don't remember how long. On my older desktop, this was not quick. I think it took maybe 30 minutes. When done though you can quickly confirm it's been updated:
You can also make WSL2 the default by doing this:
wsl --set-default-version 2. I only run one distro on my machine so this really isn't an issue for me.
Ok, done! But wait, there's some very important things to note. I did some immediate testing the first time I did an update and noticed that npm was not faster. I was disappointed, reached out on Twitter, and was reminded that if I'm still using the main Windows filesystem (
/mnt/c), file IO is still going to be slow. I did some testing under
~/ and right away saw a huge boost. I typically do all my work in
/mnt/c/projects, but simply set up
~/projects as my new place to do crap.
This then quickly led to an issue - how do I edit files there? I've got two answers to that.
First, you can browse your distro file system in Explorer.exe by going to
You'll see your distros there and can work with your file system. In my testing, I've noticed that when I copy files over to Ubuntu, I sometimes get a copy with ":Zone.Identifier" in it. This is known and I believe has something to do with AV stuff. You can read more about it here: Zone.Identifier Files when copying from Windows to WSL filestructure. For now I'm just deleting when I see them, typically before I do a git commit.
Also, I believe I read that WSL is going to be more tightly integrated into Explorer in the future. So there's that.
The next thing was getting support for Visual Studio Code. This was also pretty easy if you add the Remote-WSL extension.
You add that extension, then run "Remote-WSL: New Window". This will open a new window and do a one time download of support stuff. For me it took about 2 minutes I think. When done, you'll have nothing in the file explorer - at first:
Note that it says "Connected to remote" and it has a "WSL:Ubuntu" marker on the lower left corner. Clicking to open a folder will bring up UI on top to browse:
This was a bit weird to me at first, but once you select a folder, everything returns to normal. So here's a screen shot of my editor right now. You can see the "WSL" marks so I know it's in the Ubuntu file system, but outside of that, everything is "normal":
But wait - there's one more nit. I was testing with a Vue project and noticed I had "lost"
.vue file support. Turns out you may have to reinstall some extensions. Basically if an extension does anything UI wise, like color schemes, it will work. Other extensions have to be installed again.
This - and more - is all documented here: Developing in WSL. Honestly once I realized what was going on I didn't worry about it. VSCode makes it super easy to install extensions.
So far, that's it. I absolutely recommend upgrading, but as always, do with caution. Everything I'm doing under WSL is Git-based so I could completely lose everything and not really be impacted. Enjoy!
Oh, as a quick note, I strongly suggest you try out the new Windows Terminal. It's highly configurable, open source, and works great!
Header photo by Chris Reyem on Unsplash
I recently went through the same thing and have been really enjoying the development experience with WSL 2 and VS Code remote editing. The one thing I haven't figure out yet is how to back up those files in the WSL file system. Most of the work I do in there is attached to Git repos, but not everything. At this point I've not been able to find a good way to backup that stuff. I think I'm going to try to install Duplicati inside the Linux distro (I use it for backup for all my other machines) and see if that works. Is that something you've looked into at all?
Nope. My plan is to use GitHub for everything *except* a folder I called testingzone where I put misc crap I'm ok with losing.
I'm creating a new Angular app using the terminal (set to use wsl) inside of Visual Code. Its sooooo slow... its currently pointed to /mnt/c/...
Ray - somewhere I feel like I read you made a comment related to this being slow and alternative, but I can't recall where I saw it.
Yep - stop using /mnt and stick to the Ubuntu file system only.
query - did you recently post a reply to my last comment and delete it? I got the email, but don't see it.
Yes- I started to ask another question and realized the answer was in the article, duh!
Heh no worries!