There are two prominent toolchains on Windows:
- The one bundled with Visual Studio (not Visual Studio Code), using the MSVC compiler.
- A loose group of toolchains called MinGW, which uses the same tools you'd commonly find on Linux.
We'll be installing the later, with the Clang compiler. (Why MinGW? and Choosing the compiler and more and Why Visual Studio Code rather than Visual Studio?)
More specifically, we'll be installing it using MSYS2. (Why is MSYS2? What's the difference between "MSYS2", "MinGW", etc? and Why not the official Clang installer? and Why not WSL?)
I want GCC instead of Clang!
Are you sure?
This tutorial recommends Clang for a reason. In addition to being a good compiler in general, it gives you access to some powerful tools that'll help you catch bugs: Address Sanitizer and UB Sanitizer. (GCC supports them on Linux and elsewhere, but not on Windows.)
Clang is made to be compatible with GCC, so if you're a newbie, you'll hardly notice any difference.
If you're sure: MSYS2 has several different versions of GCC available. A good one to choose by default is MSYS2 UCRT64. For the list of different GCC and Clang versions it provides, consult this and this.
I already have MSYS2 installed!
MSYS2 provides several different compilers to choose from. If you already installed one, it may or may not be different from the one this tutorial uses.
It's easier to follow this tutorial as is, especially if you don't know what you're doing. You can reinstall MSYS2 if you prefer to start from scratch, but you don't have to.
But if you want to reuse the existing compiler you have installed, consult this.
I already have a compiler installed! (not in MSYS2)
If you're new, I recommend uninstalling it (or leaving it be), and following the tutorial as is. It'll be way easier, and there are specific reasons why I recommend this specific compiler distribution.
But if you insist on reusing it, which one do you have?
MSVC
Not covered by this tutorial. Also I have to admit, I don't see why someone would willingly use it for any reason other than it being the default choice in Visual Studio (not Code). My rant on MSVC.
Clang from the official installer
Clang on Windows is not self-sufficient. It needs either a MinGW installation or a MSVC installation (the latter can come from Visual Studio (not Code)).
When you install Clang from MSYS2, it operates in MinGW-compatible mode by default, and MinGW is automatically installed with it. This is what this tutorial recommends.
When you install Clang from most other places, including from the official installer, it'll operate in MSVC-compatible mode by default, and will error if MSVC is not installed.
Both modes are viable. MinGW has a slightly saner but less popular ABI.
If you have MSVC installed, Clang should hopefully just work by default, but any non-trivial configuration of it in MSVC mode isn't covered by this tutorial.
MinGW / GCC / Clang from winlibs.com
Should mostly work fine, I guess. It should include most of the necessary tooling, but since there's no package manager, installing third-party libraries will have to be done manually.
MinGW / GCC from elsewhere
There are many bad outdated GCC distributions out there. If you don't know what you're doing, chances are, you got one of those. If you're curious, check your GCC version (run gcc --version to see it) and compare the number with the one at https://gcc.gnu.org/ (see the most recent version in Supported Releases).
Even if you got a decent up-to-date distribution, your next problem will be having to install all the necessary tooling manually, and then configuring it (e.g. the official version of CMake uses MSVC by default on Windows, and you'll have to manually tell it to use your compiler every time; whereas in MSYS2 it'll default to their compiler).
If that sounds ok, continue with the tutorial.
Something else / I don't know
Oh well. I suggest uninstalling whatever you have to avoid interference, then continue with the tutorial normally.
-
Download the installer from https://www.msys2.org/ and install it. Don't follow the additional instructions on that page, you only need the installer.
There are two installers on that page,
msys2-x86_64-...andmsys2-arm64-.... You want the first one (unless your computer has an ARM processor, but those are rare, you'd know if you had one).(⚠ If you choose to install into a non-default location, make sure the path doesn't contain any spaces or non-latin characters. This tutorial assumes you installed to the default location
C:\msys64. I recommend not changing the location for simplicity.)Uncheck
Run MSYS2 now.at the end of installation, or close the window that it opens.If you run into any strange issues during installation (or later), try disabling your antivirus software or adding
C:\msys64to its exceptions. -
Start MSYS2.
The "Start" menu will have several different shortcuts, for now you want
MSYS2 CLANG64(read about the differences here).The window that opens is called a "terminal" or a "console". You can type commands in there. (I will explain more later.)
Make sure it says
CLANG64in purple text. If it says something else, you used the wrong shortcut (see above). Close it and restart using the correct one. (There are no lasting effects of typing commands in the wrong window. )If you instead see an error message in red, it's likely your antivirus acting up. Add
C:\msys64to its exceptions and reinstall MSYS2.All commands below should be typed into the MSYS2 terminal.
-
Update MSYS2.
Run
pacman -Syuto install updates. (It's a good idea to do this from time to time.)(⚠ If you want to paste commands from this tutorial, note that CtrlV doesn't work in MSYS2 terminal. Use ShiftInsert or right click → "Paste".)
When you run the command above, it will eventually ask for confirmation:
:: Proceed with installation? [Y/n]. Press Enter to continue.Sometimes you will get this:
:: To complete this update all MSYS2 processes including this terminal will be closed. Confirm to proceed [Y/n]. Press Enter and the terminal will close. If this happened, restart the MSYS2 terminal and runpacman -Syuagain to finish the update.When it's done updating, you'll see this again:
username@computername CLANG64 ~ $
-
Install toolchain.
Run
pacman -S mingw-w64-clang-x86_64-clangto install Clang (which automatically brings in the rest of the toolchain).(⚠ Note that we install
mingw-w64-clang-x86_64-clangand not justclang! The difference is explained here.)Now if you type
clang++ --version, you should see something like this:clang version 18.1.8 Target: x86_64-w64-windows-gnu Thread model: posix InstalledDir: C:/msys64/clang64/binWhich means Clang was installed correctly.
Now you can try compiling a simple program. See How to compile and run programs in the terminal.
