Artikel ini mengajarkan Anda tentang versi .NET mana yang didukung di Windows, cara menginstal .NET, dan apa perbedaannya antara SDK dan runtime.
Tidak seperti .NET Framework, .NET tidak terkait dengan versi Windows Anda. Anda hanya dapat menginstal versi tunggal .NET Framework di Windows. Tetapi .NET mandiri dan dapat diinstal di mana saja di komputer Anda. Beberapa aplikasi mungkin menyertakan salinan .NET mereka sendiri.
Secara default, .NET diinstal ke direktori Program Files\dotnet di komputer Anda, kecuali metode penginstalan memilih direktori yang berbeda.
.NET terdiri dari runtime dan SDK. Runtime menjalankan aplikasi .NET, dan SDK digunakan untuk membuat aplikasi.
Pilih runtime yang benar
Ada tiga runtime berbeda untuk Windows, yang memungkinkan berbagai jenis aplikasi untuk dijalankan. SDK mencakup ketiga runtime, dan alat penginstal untuk runtime mungkin menyertakan runtime tambahan. Tabel berikut ini menjelaskan runtime mana yang disertakan dengan penginstal .NET tertentu:
Installer
Menyertakan Runtime .NET
Menyertakan Runtime Desktop .NET
Termasuk ASP.NET Core Runtime
.NET Runtime
Ya
No
Tidak
Runtime Desktop .NET
Ya
Ya
Tidak
ASP.NET Core Runtime
Tidak
No
Ya
.NET SDK
Ya
Ya
Ya
Untuk memastikan bahwa Anda dapat menjalankan semua aplikasi .NET di Windows, instal ASP.NET Core Runtime dan .NET Desktop Runtime. ASP.NET Core Runtime menjalankan aplikasi berbasis web, dan .NET Desktop Runtime menjalankan aplikasi desktop, seperti Windows Presentation Foundation (WPF) atau aplikasi Formulir Windows.
Pilih cara menginstal .NET
Ada berbagai cara untuk menginstal .NET, dan beberapa produk mungkin mengelola versi .NET mereka sendiri. Jika Anda menginstal .NET melalui perangkat lunak yang mengelola versi .NET-nya sendiri, mungkin tidak diaktifkan di seluruh sistem. Pastikan Anda memahami implikasi penginstalan .NET melalui perangkat lunak lain.
Jika Anda tidak yakin metode mana yang harus Anda pilih setelah meninjau daftar di bagian berikut, Anda mungkin ingin menggunakan Penginstal .NET.
Gunakan Visual Studio untuk menginstal .NET saat Anda ingin mengembangkan aplikasi .NET menggunakan Visual Studio. Visual Studio mengelola salinan .NET sendiri. Metode ini menginstal templat SDK, Runtime, dan Visual Studio.
Instal ekstensi C# Dev Kit untuk Visual Studio Code untuk mengembangkan aplikasi .NET. Ekstensi dapat menggunakan SDK yang sudah diinstal atau menginstalnya untuk Anda.
Instal .NET dengan paket Windows Installer, yang merupakan executable yang Anda jalankan. Metode ini dapat menginstal SDK dan Runtime. Penginstalan dilakukan di seluruh sistem.
Gunakan WinGet untuk menginstal .NET saat Anda ingin mengelola .NET melalui baris perintah. Metode ini dapat menginstal SDK dan Runtime. Penginstalan dilakukan di seluruh sistem.
Sebagai pengingat, tabel ini berlaku untuk .NET modern (dibandingkan dengan .NET Framework). Untuk menginstal .NET Framework, lihat panduan Penginstalan .NET Framework.
Tanggal akhir layanan versi Windows 10 disegmentasi berdasarkan edisi. Hanya edisi Home, Pro, Pro Education, dan Pro for Workstations yang dipertimbangkan dalam tabel berikut. Periksa lembar fakta siklus hidup Windows untuk detail tertentu.
Sistem Operasi
.NET 9 (Arsitektur)
.NET 8 (Arsitektur)
Windows 11 (24H2, 23H2, 22H2 Ent/Edu)
✔️ x64, x86, Arm64
✔️ x64, x86, Arm64
Windows 10 (22H2+)
✔️ x64, x86, Arm64
✔️ x64, x86, Arm64
Windows Server 2025 Windows Server 2022 Server Windows 2019 Windows Server, Versi 1903 atau yang lebih baru Server Windows 2016 Windows Server 2012 R2 Windows Server 2012
Tidak ada lagi versi .NET yang didukung pada Windows 7 dan Windows 8.1. Rilis terakhir yang didukung adalah .NET 6 dan dukungan berakhir pada 12 November 2024.
Windows Server 2012 masih didukung oleh versi .NET apa pun yang masih didukung.
Ketiga versi Windows ini memerlukan dependensi lebih lanjut untuk diinstal:
Microsoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows Server 2012
Microsoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows Server 2012 R2
Microsoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Persyaratan sebelumnya juga diperlukan jika Anda menerima kesalahan yang terkait dengan salah satu dll berikut:
api-ms-win-crt-runtime-l1-1-0.dll
api-ms-win-cor-timezone-l1-1-0.dll
hostfxr.dll
PC Windows berbasis arm
.NET didukung pada PC Windows berbasis Arm. Bagian berikut menjelaskan hal-hal yang harus Anda pertimbangkan saat menginstal .NET.
Perbedaan jalur
Pada PC Windows berbasis Arm, semua versi Arm64 .NET diinstal ke folder C:\Program Files\dotnet\ normal. Namun, versi x64 dari .NET SDK diinstal ke folder C:\Program Files\dotnet\x64\ .
Variabel jalur
Variabel lingkungan yang menambahkan .NET ke jalur sistem, seperti PATH variabel, mungkin perlu diubah jika Anda menginstal versi x64 dan Arm64 dari .NET SDK. Selain itu, beberapa alat mengandalkan DOTNET_ROOT variabel lingkungan, yang juga perlu diperbarui untuk menunjuk ke folder penginstalan .NET SDK yang sesuai.
Menginstal dengan Visual Studio
Visual Studio menginstal salinan .NET sendiri yang terpisah dari salinan .NET lainnya. Versi Visual Studio yang berbeda mendukung versi .NET yang berbeda. Versi terbaru Visual Studio selalu mendukung versi terbaru .NET.
Alat Penginstal Visual Studio menginstal dan mengonfigurasi Visual Studio. Beberapa beban kerja Visual Studio termasuk .NET, seperti ASP.NET dan pengembangan web dan pengembangan UI Aplikasi Multi-platform .NET. Versi spesifik .NET dapat diinstal melalui tab Komponen Individual.
Dokumentasi Visual Studio menyediakan instruksi tentang cara:
Jika Anda menggunakan Visual Studio untuk mengembangkan aplikasi .NET, tabel berikut ini menjelaskan versi minimum Visual Studio yang diperlukan berdasarkan versi .NET SDK target.
Versi .NET SDK
Versi Visual Studio
9
Visual Studio 2022 versi 17.12 atau yang lebih tinggi.
8
Visual Studio 2022 versi 17.8 atau yang lebih tinggi.
7
Visual Studio 2022 versi 17.4 atau yang lebih tinggi.
6
Visual Studio 2022 versi 17.0 atau yang lebih tinggi.
5
Visual Studio 2019 versi 16.8 atau yang lebih tinggi.
3.1
Visual Studio 2019 versi 16.4 atau yang lebih tinggi.
3.0
Visual Studio 2019 versi 16.3 atau yang lebih tinggi.
2.2
Visual Studio 2017 versi 15.9 atau yang lebih tinggi.
2.1
Visual Studio 2017 versi 15.7 atau yang lebih tinggi.
Jika Sudah menginstal Visual Studio, Anda dapat memeriksa versi Anda dengan langkah-langkah berikut.
Buka Visual Studio.
Pilih Bantuan>Tentang Microsoft Visual Studio.
Baca nomor versi dari dialog Tentang .
Untuk informasi selengkapnya tentang, lihat penerapan versi .NET SDK, MSBuild, dan Visual Studio.
Menginstal dengan Visual Studio Code
Visual Studio Code adalah editor kode sumber yang kuat dan ringan yang berjalan di desktop Anda. Visual Studio Code dapat menggunakan SDK yang sudah diinstal pada sistem Anda. Selain itu, ekstensi C# Dev Kit akan menginstal .NET untuk Anda jika belum diinstal.
Pilih versi .NET yang ingin Anda unduh, seperti 9.0.
Temukan kotak SDK atau Runtime yang berisi tautan untuk mengunduh .NET.
Di bawah kolom Penginstal , temukan baris Windows dan pilih tautan untuk arsitektur CPU Anda. Jika Anda tidak yakin, pilih x64 karena ini adalah yang paling umum.
Browser harus secara otomatis mengunduh alat penginstal.
Tip
Gambar berikut menunjukkan SDK, tetapi Anda juga dapat mengunduh Runtime.
Buka Windows Explorer dan navigasikan ke tempat file diunduh, kemungkinan besar folder Unduhan Anda.
Klik dua kali pada file untuk menginstal .NET.
Dialog Penginstal Windows dibuka.
Pilih Instal dan ikuti instruksi untuk menginstal .NET.
Untuk mempelajari cara menggunakan .NET CLI, lihat gambaran umum .NET CLI.
Opsi baris perintah
/? Gunakan parameter untuk menampilkan daftar opsi.
Jika Anda ingin menginstal .NET secara diam-diam, seperti di lingkungan produksi atau untuk mendukung integrasi berkelanjutan, gunakan opsi berikut:
/install
Menginstal .NET.
/quiet
Mencegah UI dan perintah ditampilkan.
/norestart
Menekan setiap upaya untuk memulai ulang.
Alat penginstal mengembalikan kode keluar 0 untuk keberhasilan dan kode keluar 3010 untuk menunjukkan bahwa hidupkan ulang diperlukan. Nilai lain kemungkinan besar adalah kode kesalahan.
Microsoft Update
Executable penginstal .NET adalah produk independen yang dapat dilayankan menggunakan Microsoft Update (MU) di Windows. MU berbeda dengan Windows Update (WU), yang digunakan untuk melayani komponen sistem operasi seperti .NET Framework.
Perbaikan keamanan dan non-keamanan untuk versi .NET yang didukung disediakan melalui MU menggunakan beberapa saluran distribusi. Pembaruan Otomatis (AU) relevan untuk pengguna akhir dan konsumen, sementara Window Server Update Services (WSUS) dan Katalog Pembaruan Windows relevan untuk administrator TI.
Executable penginstal .NET mendukung penginstalan berdampingan (SxS) di seluruh rilis utama dan minor untuk arsitektur dan komponen yang berbeda, seperti runtime dan SDK. Misalnya, Anda dapat menginstal runtime 6.0.15 (x64) dan 6.0.17 (x86). Ketika MU memicu, itu akan menawarkan alat penginstal terbaru untuk kedua instalasi.
Memblokir pembaruan
Meskipun sebagian besar pengguna lebih suka diperbarui, dimungkinkan untuk memblokir pembaruan .NET menggunakan kunci registri dalam tabel berikut.
Versi .NET
Kunci Registri
Nama
Jenis
Nilai
Semua
HKLM\SOFTWARE\Microsoft\.NET
BlockMU
REG_DWORD
0x00000001
.NET 9
HKLM\SOFTWARE\Microsoft\.NET\9.0
BlockMU
REG_DWORD
0x00000001
.NET 8
HKLM\SOFTWARE\Microsoft\.NET\8.0
BlockMU
REG_DWORD
0x00000001
.NET 7
HKLM\SOFTWARE\Microsoft\.NET\7.0
BlockMU
REG_DWORD
0x00000001
.NET 6
HKLM\SOFTWARE\Microsoft\.NET\6.0
BlockMU
REG_DWORD
0x00000001
.NET 5
HKLM\SOFTWARE\Microsoft\.NET\5.0
BlockMU
REG_DWORD
0x00000001
.NET Core 3.1
HKLM\SOFTWARE\Microsoft\.NET\3.1
BlockMU
REG_DWORD
0x00000001
.NET Core 2.1
HKLM\SOFTWARE\Microsoft\.NET\2.1
BlockMU
REG_DWORD
0x00000001
Pembaruan otomatis untuk OS Server
Pembaruan untuk sistem operasi server didukung oleh WSUS dan Katalog Pembaruan Microsoft, tetapi bukan AU. Sistem operasi server dapat memilih untuk menerima pembaruan melalui AU menggunakan kunci registri berikut.
Versi .NET
Kunci Registri
Nama
Jenis
Nilai
Semua
HKLM\SOFTWARE\Microsoft\.NET
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 9
HKLM\SOFTWARE\Microsoft\.NET\9.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 8
HKLM\SOFTWARE\Microsoft\.NET\8.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 7
HKLM\SOFTWARE\Microsoft\.NET\7.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 6
HKLM\SOFTWARE\Microsoft\.NET\6.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 5
HKLM\SOFTWARE\Microsoft\.NET\5.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET Core 3.1
HKLM\SOFTWARE\Microsoft\.NET\3.1
AllowAUOnServerOS
REG_DWORD
0x00000001
Pilih kapan versi sebelumnya dihapus
Alat penginstal yang dapat dieksekusi selalu menginstal konten baru sebelum menghapus penginstalan sebelumnya. Aplikasi yang berjalan mungkin terganggu atau crash ketika runtime yang lebih lama dihapus. Untuk meminimalkan dampak pembaruan .NET, Anda dapat menentukan kapan penginstalan .NET sebelumnya harus dihapus menggunakan kunci registri.
Versi .NET
Kunci Registri
Nama
Jenis
Nilai
Semua
HKLM\SOFTWARE\Microsoft\.NET
RemovePreviousVersion
REG_SZ
always, never, atau nextSession
.NET 9
HKLM\SOFTWARE\Microsoft\.NET\9.0
RemovePreviousVersion
REG_SZ
always, never, atau nextSession
.NET 8
HKLM\SOFTWARE\Microsoft\.NET\8.0
RemovePreviousVersion
REG_SZ
always, never, atau nextSession
never mempertahankan penginstalan sebelumnya dan memerlukan intervensi manual untuk menghapus penginstalan .NET sebelumnya.
always menghapus penginstalan sebelumnya setelah versi baru diinstal. Ini adalah perilaku default di .NET.
nextSession menangguhkan penghapusan hingga sesi masuk berikutnya dari anggota di grup Administrator.
Nilai adalah nilai yang tidak peka huruf besar/kecil dan tidak valid default ke always.
Ketika penghapusan ditangguhkan, alat penginstal menulis perintah ke kunci registri RunOnce untuk menghapus instalan versi sebelumnya. Perintah hanya dijalankan jika pengguna di grup Administrator masuk ke komputer.
Catatan
Fitur ini hanya tersedia di .NET 8 (8.0.11), 9, dan versi .NET yang lebih baru. Ini hanya berlaku untuk executable alat penginstal mandiri dan memengaruhi distribusi seperti WinGet yang menggunakannya.
Instal dengan Pengelola Paket Windows (WinGet)
Anda dapat menginstal dan mengelola .NET melalui layanan Pengelola Paket Windows, menggunakan alat iniwinget.exe. Untuk informasi selengkapnya tentang cara menginstal dan menggunakan WinGet, lihat Menggunakan alat winget untuk menginstal dan mengelola aplikasi.
Jika Anda menginstal .NET system-wide, instal dengan hak istimewa administratif.
Untuk mempelajari cara menggunakan .NET CLI, lihat gambaran umum .NET CLI.
Mencari versi
winget search Gunakan perintah untuk mencari versi paket yang berbeda yang ingin Anda instal. Misalnya, perintah berikut mencari semua .NET SDK yang tersedia melalui WinGet:
Windows Command Prompt
winget search Microsoft.DotNet.SDK
Hasil pencarian dicetak dalam tabel dengan setiap pengidentifikasi paket.
Output
Name Id Version Source
----------------------------------------------------------------------------------------------
Microsoft .NET SDK 9.0 Microsoft.DotNet.SDK.9 9.0.100 winget
Microsoft .NET SDK 8.0 Microsoft.DotNet.SDK.8 8.0.300 winget
Microsoft .NET SDK 7.0 Microsoft.DotNet.SDK.7 7.0.409 winget
Microsoft .NET SDK 6.0 Microsoft.DotNet.SDK.6 6.0.422 winget
Microsoft .NET SDK 5.0 Microsoft.DotNet.SDK.5 5.0.408 winget
Microsoft .NET SDK 3.1 Microsoft.DotNet.SDK.3_1 3.1.426 winget
Menginstal versi pratinjau
Jika versi pratinjau tersedia, ganti nomor versi di Id dengan kata Preview. Contoh berikut menginstal rilis pratinjau .NET Desktop Runtime:
Menginstal .NET melalui dotnet-install skrip PowerShell direkomendasikan untuk integrasi berkelanjutan dan penginstalan nonadmin. Jika Anda menginstal .NET untuk penggunaan normal pada sistem Anda, gunakan penginstal .NET atau metode penginstalan Pengelola Paket Windows.
Skrip default untuk menginstal versi dukungan jangka panjang (LTS) terbaru, yaitu .NET 8. Anda dapat memilih rilis tertentu dengan menentukan sakelar -Channel . Sertakan sakelar -Runtime untuk menginstal runtime. Jika tidak, skrip menginstal SDK. Skrip tersedia di dan kode sumber dihosting https://dot.net/v1/dotnet-install.ps1 di GitHub.
Buka PowerShell dan navigasikan ke folder yang berisi skrip.
Jalankan perintah berikut untuk menginstal .NET SDK.
PowerShell
dotnet-install.ps1
Catatan
SDK diinstal dengan menghilangkan sakelar -Runtime .
Untuk mempelajari cara menggunakan .NET CLI, lihat gambaran umum .NET CLI.
Validasi
Setelah mengunduh penginstal atau rilis biner, verifikasi untuk memastikan bahwa file belum diubah atau rusak. Anda dapat memverifikasi checksum di komputer Anda lalu membandingkannya dengan apa yang dilaporkan di situs web unduhan.
Saat Anda mengunduh file dari halaman unduhan resmi, checksum untuk file ditampilkan dalam kotak teks. Pilih tombol Salin untuk menyalin nilai checksum ke clipboard Anda.
Anda dapat menggunakan PowerShell atau Command Prompt untuk memvalidasi checksum file yang telah Anda unduh. Misalnya, perintah berikut melaporkan checksum file dotnet-sdk-8.0.100-win-x64.exe :
Bandingkan checksum dengan nilai yang disediakan oleh situs unduhan.
Menggunakan PowerShell dan file checksum untuk memvalidasi
Catatan rilis .NET berisi tautan ke file checksum yang dapat Anda gunakan untuk memvalidasi file yang diunduh. Langkah-langkah berikut menjelaskan cara mengunduh file checksum dan memvalidasi biner penginstalan .NET:
Jika Anda melihat Salah dicetak, file yang Anda unduh tidak valid dan tidak boleh digunakan.
Pemecahan Masalah
Setelah menginstal .NET SDK, Anda mungkin mengalami masalah saat mencoba menjalankan perintah .NET CLI. Bagian ini mengumpulkan masalah umum tersebut dan memberikan solusi.
Kemungkinan besar Anda menginstal versi x86 (32-bit) dan x64 (64-bit) dari .NET SDK. Ini menyebabkan konflik karena ketika Anda menjalankan dotnet perintah, itu menyelesaikan ke versi x86 ketika harus diselesaikan ke versi x64. Masalah ini diperbaiki dengan menyesuaikan %PATH% variabel untuk menyelesaikan versi x64 terlebih dahulu.
Verifikasi bahwa Anda memiliki kedua versi yang diinstal dengan menjalankan where.exe dotnet perintah . Jika demikian, Anda akan melihat entri untuk folder Program Files\ dan Program Files (x86)\ . Jika folder Program Files (x86)\ adalah yang pertama, seperti yang ditunjukkan oleh contoh berikut, itu salah dan Anda harus melanjutkan ke langkah berikutnya.
Jika sudah benar dan Program Files\ adalah yang pertama, Anda tidak memiliki masalah yang dibahas bagian ini dan Anda harus membuat masalah permintaan bantuan .NET di GitHub
Tekan tombol Windows dan ketik "Edit variabel lingkungan sistem" ke dalam pencarian. Pilih Edit variabel lingkungan sistem.
Jendela Properti Sistem terbuka hingga Tab Tingkat Lanjut. Pilih Variabel Lingkungan.
Pada jendela Variabel Lingkungan, di bawah grup Variabel sistem, pilih baris Jalur* lalu pilih tombol Edit .
Gunakan tombol Pindah ke Atas dan Pindah ke Bawah untuk memindahkan entri C:\Program Files\dotnet\ di atas C:\Program Files (x86)\dotnet\.
Membangun aplikasi lebih lambat dari yang diharapkan
Pastikan Smart App Control, fitur Windows, nonaktif. Kontrol Aplikasi Pintar tidak disarankan untuk diaktifkan pada komputer yang digunakan untuk pengembangan. Pengaturan apa pun selain "nonaktif" mungkin berdampak negatif pada performa SDK.
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
Umpan balik .NET
.NET adalah proyek sumber terbuka. Pilih tautan untuk memberikan umpan balik:
.NET adalah platform pengembang sumber terbuka gratis, lintas platform untuk membangun berbagai jenis aplikasi. Dengan .NET, Anda dapat menggunakan beberapa bahasa, editor, dan pustaka untuk membangun situs, seluler, desktop, permainan, dan IoT.