Visual Studio nie widzi toolsetów MSVC

Visual Studio niewidzące toolsetów MSVC wskazuje na brak zainstalowanego zestawu narzędzi kompilatora C++ w instalatorze.

Co oznacza brak toolsetu MSVC w Visual Studio

Komunikat, że Visual Studio nie widzi toolsetów MSVC, oznacza zwykle, że środowisko nie ma dostępnego zestawu narzędzi Microsoft Visual C++ przeznaczonego dla wybranej konfiguracji projektu. MSVC, czyli Microsoft C++ toolchain, obejmuje między innymi kompilator cl.exe, linker link.exe, biblioteki standardowe oraz pliki nagłówkowe potrzebne do budowania programów w języku C i C++. Samo zainstalowanie środowiska Visual Studio nie zawsze oznacza zainstalowanie komponentów C++.

Toolset jest przypisany do konkretnej generacji narzędzi, na przykład MSVC v143 używanego przez Visual Studio 2022 albo MSVC v142 kojarzonego z Visual Studio 2019. Projekt może wymagać konkretnej wersji wskazanej w ustawieniu Platform Toolset. Jeżeli w systemie znajduje się tylko nowszy lub starszy zestaw, Visual Studio może zgłosić brak wymaganej wersji, mimo że pewne pliki kompilatora są obecne.

Komponenty instalowane przez Visual Studio Installer

Podstawowym miejscem weryfikacji jest Visual Studio Installer. Przy wybranej instalacji należy sprawdzić obciążenie Desktop development with C++. W jego skład powinien wchodzić odpowiedni komponent MSVC dla używanej wersji Visual Studio, na przykład MSVC v143 - VS 2022 C++ x64/x86 build tools. Nazwa komponentu może różnić się zależnie od wydania instalatora, ale musi jednoznacznie wskazywać narzędzia kompilatora C++ dla właściwego Visual Studio.

Warto zweryfikować także instalację Windows SDK, ponieważ toolset MSVC korzysta z nagłówków, bibliotek systemowych i narzędzi dostarczanych przez SDK. Brak SDK może powodować błędy linkowania albo brak plików nagłówkowych, choć sam kompilator jest już zainstalowany. Jeśli projekt wymaga starszej wersji MSVC, trzeba zaznaczyć konkretny starszy toolset w sekcji pojedynczych komponentów. Zmiana ustawienia projektu na nowszy toolset jest możliwa tylko wtedy, gdy kod i używane biblioteki są z nim zgodne.

Sprawdzenie konfiguracji projektu i środowiska kompilacji

Po instalacji należy otworzyć właściwą wersję Visual Studio oraz sprawdzić konfigurację projektu w właściwościach rozwiązania. Istotne są pola Configuration, Platform i Platform Toolset. Przykładowo konfiguracja Debug dla platformy x64 może używać innego zestawu ustawień niż Release dla Win32. W przypadku projektu C++ ustawienie toolsetu powinno odpowiadać faktycznie zainstalowanej wersji MSVC. Po zmianie komponentów warto wykonać czyszczenie rozwiązania, a następnie pełną kompilację, aby usunąć pozostałości wcześniejszej konfiguracji.

Można również sprawdzić narzędzia poza interfejsem IDE, uruchamiając odpowiedni Developer Command Prompt for Visual Studio. Polecenie where cl pokaże, czy system odnajduje kompilator w aktualnym środowisku. Polecenie cl wyświetli wersję kompilatora, jeśli zmienne środowiskowe zostały prawidłowo ustawione. Skrypt vcvarsall.bat przygotowuje środowisko dla określonej architektury, między innymi x86, x64 lub ARM64. Zwykły wiersz polecenia może nie zawierać ścieżek do MSVC, dlatego brak wyniku polecenia where cl w tym miejscu nie musi oznaczać uszkodzonej instalacji.

Naprawa instalacji i dalsza diagnostyka Visual Studio

Jeżeli wymagany komponent jest zaznaczony, a toolset nadal nie pojawia się w projekcie, należy użyć funkcji Repair w Visual Studio Installer. Naprawa ponownie sprawdza pliki instalacyjne i odtwarza brakujące elementy. Gdy problem występuje tylko w jednym rozwiązaniu, przyczyną może być zapisany w pliku projektu wymóg nieobecnej wersji toolsetu, błędna platforma albo konfiguracja odziedziczona z innego komputera. W takiej sytuacji trzeba porównać wartość PlatformToolset w pliku projektu z komponentami widocznymi w instalatorze.

Projekty korzystające z CMake mogą dodatkowo wskazywać generator Visual Studio i architekturę w sposób niezależny od ustawień zwykłego projektu. Wygenerowanie katalogu kompilacji przy użyciu nieodpowiedniego generatora może prowadzić do pozornego braku toolsetu. Pomocne jest usunięcie wyłącznie katalogu wynikowego CMake i ponowne wygenerowanie konfiguracji po sprawdzeniu instalacji. W przypadku laptopa lub komputera PC problem może wymagać analizy instalatora Visual Studio, pliku projektu, zmiennych środowiskowych oraz logów kompilacji. Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów, w tym diagnostyką problemów z oprogramowaniem używanym do pracy na takim sprzęcie.