Hello. This is kind of continuation of this post https://codeforces.me/blog/entry/102287. In this tutorial I'll try to explain how to write and compile C++ code on Windows, using tools provided by (mostly) Microsoft. I'm going to use latest versions.
Terminal
First of all, let's install Windows Terminal and MS PowerShell. Standart windows command line is just not usable. Let's also install winget — this is a package manager similar to, for example, homebrew. Maybe chocolatey is better but, again, this one is developed by Microsoft.
Of course Microsoft Store isn't mandatory, you can use any other source for these packages.
I'd also suggest to try starship command prompt — very useful tool, supports powershell as well.
Compilers and tools
Open powershell and install Visual Studio 2022 Build Tools:
winget install Microsoft.VisualStudio.2022.BuildTools
This package actually installs the installer without any components. Now run this installer: type appwiz
in powershell, find "Visual Studio Build Tools 2022" in the list, right click, "change". Open "Individual components" tab and look for the following:
- MSVC ver. 143 (or later) for your platform
- C++ clang for Windows
- cmake
- Windows SDK (latest version for your platform; I'm using Windows 11 SDK version
10.0.22000.0
)
Run this installer from time to time to check for updates
Developer command prompt
In order to properly use all these compilers, you need to set up PATH and other environment variables. Microsoft provides special scripts for that. The usual suggestion is to just open "Visual Studio Developer Command Prompt" from your start menu, but we can actually do it much better. Let's use vssetup powershell module:
Install-Module vssetup -Scope CurrentUser
$i = (Get-VSSetupInstance)
Import-Module "$($i.InstallationPath)/Common7/Tools/Microsoft.VisualStudio.DevShell.dll"
Enter-VsDevShell $i.Instanceid -DevCmdArguments '-arch=amd64 -host_arch=amd64'
Replace amd64
with your desired architecture and save this script to file, say devshell.ps1
. Now run this script in powershell and you'll get a proper development environment (devshell, as I call it). You can try compiling your code at this point: write something and type clang -std=c++20 program.cpp
.
Editor
Yeah, I know that Microsoft provides its Visual Studio Code but I personally don't like this editor (it was too slow on my old laptop when I was a poor student. I'm not poor anymore, but still!). So let's install Sublime Text:
winget install SublimeHQ.SublimeText.4
Add sublime text installation folder to your PATH so you'll be able to launch it from console by typing subl
. Run
rundll32 sysdm.cpl,EditEnvironmentVariables
Run freshly installed sublime text, open menu by hitting Ctrl+Shift+P, and select "Install package control". Open this menu again and select "Install Package — LSP".
LSP provides code diagnostics, navigation ("go to definition"), autocompletion and code formatting capabilities, We got clangd
for C++, let's set it up. Open "Preferences — Package Settings — LSP — Settings" and look for "clangd" on the left pane. Copy it to the right pane, so your "LSP.sublime-settings" file should look something like
{
"clients": {
"clangd": {
"enabled": true,
"command": [
"clangd",
"--compile-commands-dir=build"
],
"selector": "source.c | source.c++ | source.objc | source.objc++",
"auto_complete_selector": "punctuation.accessor | (meta.preprocessor.include string - punctuation.definition.string.end)",
},
}
}
Clangd requires JSON compilation database (file compile_commands.json
) to work properly. --compile-commands-dir=build
tells it that this file is located in build
subdirectory.
Keep in mind that sublime text should be launched from devshell, otherwise it won't be able to find clangd and everything else.
C++ project
I'm going to use cmake here. Cmake is a tool which generates build files for various build systems. Sublime text build system is supported as well, so let's use it! Create file CMakeLists.txt
with the following content:
cmake_minimum_required(VERSION 3.21)
set(CMAKE_C_COMPILER clang)
set(CMAKE_CXX_COMPILER clang)
set(CMAKE_EXPORT_COMPILE_COMMANDS on)
project(contest)
foreach(problem A B C)
add_executable($$${problem} $$${problem}.cpp)
target_compile_features(${problem} PRIVATE cxx_std_20)
endforeach()
(I have no idea why it keeps replacing 1 dollar sign with 3. Anyway, it should be 1). It assumes that you have a contest with 3 problems named A, B, C; you use clang and C++20. Now
mkdir build
cd build
cmake -G"Sublime Text 2 - Ninja" ..
you'll notice the file contest.sublime-project
in your build
folder. Open it in sublime text:
subl .\build\contest.sublime-project
Write something useful in A,cpp, select the appropriate build system (Tools — Build system — "contest — A") and hit Ctrl+B. Your file will be compiled. If you want to compile from console, type ninja A
(or ninja -C build A
depending of directory).
That's it I guess? My initial idea was to also write about visual debugger (https://github.com/daveleroy/sublime_debugger) but I actually almost don't use it