.NET SDK nie zainstalowany

Brak zainstalowanego .NET SDK uniemożliwia kompilację i budowanie aplikacji .NET (w odróżnieniu od samego Runtime, który tylko je uruchamia) — SDK trzeba pobrać osobno ze strony Microsoftu.

.NET SDK nie zainstalowany — co oznacza ten komunikat

Informacja o braku zainstalowanego .NET SDK oznacza, że w systemie nie ma zestawu narzędzi potrzebnych do tworzenia, kompilowania i budowania aplikacji napisanych w technologii .NET. Samo środowisko uruchomieniowe, czyli .NET Runtime, pozwala otwierać gotowe programy, ale nie zapewnia poleceń ani komponentów wymaganych podczas pracy nad kodem źródłowym.

SDK obejmuje między innymi interfejs wiersza poleceń dotnet, kompilatory, narzędzia do przywracania zależności oraz mechanizmy tworzenia paczek i publikowania aplikacji. Bez niego polecenia takie jak dotnet build, dotnet restore albo dotnet run mogą kończyć się komunikatem o braku odpowiedniego zestawu. Problem może wystąpić zarówno przy rozpoczynaniu nowego projektu, jak i podczas otwierania istniejącego rozwiązania pobranego z repozytorium.

Nie zawsze oznacza to całkowity brak platformy .NET. Na komputerze może znajdować się wyłącznie Runtime, starsza wersja SDK albo instalacja niewidoczna dla używanego terminala. Znaczenie ma również zgodność wersji wymaganej przez projekt z wersją dostępną lokalnie.

Różnica między SDK, Runtime i narzędziem programistycznym

Runtime służy przede wszystkim do uruchamiania aplikacji. SDK jest przeznaczone do ich przygotowywania, dlatego zawiera dodatkowe składniki potrzebne do kompilacji i budowania. Z tego powodu instalacja samego Runtime nie rozwiązuje błędu pojawiającego się przy próbie utworzenia projektu lub jego skompilowania.

Weryfikację można rozpocząć od polecenia dotnet --info albo dotnet --list-sdks. Pierwsze polecenie pokazuje informacje o środowisku, ścieżkach i wykrytych składnikach, a drugie pozwala sprawdzić, czy system rozpoznaje jakąkolwiek wersję SDK. Jeżeli lista jest pusta, zwykle oznacza to brak zestawu deweloperskiego. Jeżeli wersja jest widoczna, przyczyny należy szukać między innymi w ustawieniach projektu, zmiennej PATH albo pliku global.json.

W projektach .NET istotna bywa dokładna wersja wskazana w pliku projektu lub w konfiguracji rozwiązania. Nowsze SDK nie zawsze zastępuje wszystkie starsze komponenty wymagane przez konkretną aplikację. Przydatne może być także sprawdzenie, czy używane środowisko programistyczne korzysta z tego samego systemowego polecenia dotnet co terminal. Czasem SDK zostaje zainstalowane poprawnie, ale edytor uruchomiony wcześniej nie odświeżył informacji o dostępnych narzędziach.

Typowe przyczyny i objawy braku .NET SDK

Najczęściej problem pojawia się po instalacji wyłącznie środowiska uruchomieniowego, po usunięciu starszych narzędzi deweloperskich albo po przeniesieniu projektu na inny komputer. Błąd może również wystąpić po zmianie wersji systemu, aktualizacji środowiska programistycznego lub skopiowaniu projektu, który wymaga dodatkowych składników niewystępujących w podstawowej instalacji.

• polecenie dotnet --list-sdks nie zwraca żadnej wersji;
• podczas kompilacji pojawia się informacja o braku SDK lub odpowiedniego target framework;
• projekt otwiera się w edytorze, ale nie można go zbudować ani uruchomić w trybie deweloperskim;
• terminal rozpoznaje inne wydanie dotnet niż środowisko używane przez edytor;
• plik global.json wskazuje wersję, której nie ma na komputerze;
• przywracanie pakietów nie kończy się poprawnie, mimo że sam program dotnet jest dostępny.

Nie należy usuwać przypadkowych folderów ani instalować wielu wydań bez sprawdzenia wymagań projektu. W pierwszej kolejności warto odczytać komunikat błędu, ustalić wersję platformy wskazaną w pliku projektu i porównać ją z wynikiem poleceń diagnostycznych. Znaczenie może mieć także architektura systemu, uprawnienia użytkownika, uszkodzona zmienna środowiskowa oraz pozostałości po wcześniejszej instalacji.

Kiedy trzeba zgłosić sprzęt do serwisu - .NET SDK nie zainstalowany

Do serwisu warto zgłosić się wtedy, gdy instalacja SDK kończy się błędem, system nie wykrywa poprawnie narzędzi, a projekt nadal nie daje się zbudować pomimo zainstalowania właściwego pakietu. Szczególnie pomocna może być konsultacja, gdy problem dotyczy jednocześnie konfiguracji systemu, środowiska programistycznego i konkretnego rozwiązania .NET. W ramach obsługi Warszawskiego Pogotowia Komputerowego 24/7 wykonywana jest darmowa diagnoza LAPTOPA, co pozwala najpierw ustalić, czy źródłem trudności jest brak SDK, niezgodność wersji, błędna ścieżka systemowa czy uszkodzenie samej instalacji.

Podczas sprawdzania można zweryfikować obecność wymaganych wydań SDK, działanie polecenia dotnet w różnych powłokach, ustawienia zmiennych środowiskowych oraz zależności zapisane w projekcie. W razie potrzeby analizuje się także logi kompilatora, zawartość pliku global.json, konfigurację edytora i sposób przywracania pakietów. Takie podejście ogranicza ryzyko naprawienia jedynie objawu, na przykład zainstalowania przypadkowej wersji SDK bez usunięcia konfliktu z konfiguracją projektu.

Po uporządkowaniu instalacji warto ponownie wykonać polecenia diagnostyczne, przywrócić zależności i przeprowadzić kompilację testową. Jeżeli aplikacja ma być przekazywana na inny komputer, należy dodatkowo rozdzielić wymagania potrzebne do tworzenia programu od składników koniecznych wyłącznie do jego uruchomienia. Dzięki temu łatwiej ustalić, które elementy powinny znaleźć się na stanowisku programistycznym, a które na komputerze użytkownika końcowego.