Bạn cài .NET SDK, dotnet build chạy tốt trên máy mình, rồi deploy lên server và nhận lỗi “You must install .NET to run this application”. Hoặc ngược lại: server có runtime, nhưng máy dev của đồng nghiệp không build được vì thiếu SDK. Hai triệu chứng khác nhau, cùng một gốc: bạn chưa tách runtime khỏi SDK. Hiểu đúng hệ sinh thái .NET — cái gì là nền tảng, cái gì là runtime, cái gì là SDK — giúp bạn đọc được dotnet --info, biết môi trường đang thiếu gì, và chọn đúng mô hình triển khai thay vì copy lệnh từ blog cũ.
Cập nhật 2026:
- .NET 10 LTS (10.0.14) là bản production hiện tại, hỗ trợ đến 14/11/2028. .NET 8 (8.0.33) và .NET 9 (9.0.22) hết hỗ trợ ngày 10/11/2026 — tại thời điểm viết bài chỉ còn vài ngày.
- .NET 11 đang ở RC3, GA dự kiến tháng 11/2026, là bản STS. Không đưa lên production ngay khi GA nếu hệ thống cần hỗ trợ dài hạn.
- SDK 10 bổ sung file-based app (
dotnet run app.cs),dnx/dotnet tool exec, publish container trực tiếp, và hỗ trợ Microsoft.Testing.Platform chodotnet test. - .NET 10 đi kèm C# 14; C# 15 chỉ là preview cho .NET 11, chưa phát hành.
Mục lục
Hệ sinh thái .NET: nền tảng, runtime, SDK và CLI là bốn thứ khác nhau
Hãy tách câu “cài .NET” thành các câu hỏi riêng: máy này cần chạy ứng dụng hay xây ứng dụng? Ứng dụng là web/API, desktop, mobile hay CLI? Ai chịu trách nhiệm vá bảo mật — bạn hay nhà cung cấp hạ tầng? Câu trả lời quyết định bạn cần runtime, SDK, hay cả hai.
| Lớp | Vai trò | Cài ở đâu |
|---|---|---|
| .NET (nền tảng) | Tên chung cho runtime, thư viện, SDK và công cụ; biểu hiện qua TFM như net10.0 |
Không cài như một gói duy nhất |
| Runtime (CoreCLR) | Chạy IL: JIT, GC, type system, loader | Máy chạy app, server, container |
| BCL | Thư viện chuẩn System.*, nằm trong shared framework |
Đi kèm runtime, không cài riêng |
| SDK | Build, test, publish: MSBuild, Roslyn, NuGet client, template, CLI | Máy dev và CI |
CLI (dotnet) |
Mặt tiền dòng lệnh; điều phối SDK hoặc host ứng dụng | Đi kèm SDK; host có sẵn cùng runtime |
| NuGet | Định dạng gói, client và feed cho thư viện bên thứ ba | Client nằm trong SDK; feed là dịch vụ |
| Workload | Gói hỗ trợ nền tảng tùy chọn: MAUI, Aspire, wasm-tools | Cài thêm vào SDK |
| Template | Bộ file khởi tạo dự án qua dotnet new |
Cài thêm vào SDK |
Điểm dễ nhầm nhất: SDK chứa runtime, nhưng runtime không chứa SDK. Đó là lý do máy dev cần SDK, còn server chỉ cần runtime hoặc image runtime.
Runtime: CoreCLR, Mono và Native AOT
Khi bạn build, MSBuild gọi Roslyn biên dịch C# thành IL (Intermediate Language) trong file .dll, kèm metadata. IL không phải mã máy. Khi chạy, host đọc MyApp.runtimeconfig.json, chọn shared framework phù hợp, nạp CoreCLR, rồi JIT biên dịch IL sang mã máy cho CPU và OS hiện tại. Nhờ vậy cùng một .dll chạy được trên Windows, Linux và macOS.
Ba shared framework thường gặp: Microsoft.NETCore.App (CoreCLR + BCL), Microsoft.AspNetCore.App (ASP.NET Core), Microsoft.WindowsDesktop.App (WinForms/WPF). Một web API tham chiếu hai framework đầu; dotnet --list-runtimes liệt kê chúng thành hai dòng riêng.
| Runtime | Dùng cho | Đặc điểm |
|---|---|---|
| CoreCLR | ASP.NET Core, console, desktop, service | JIT + tiered compilation, GC, hỗ trợ dynamic code |
| Mono | iOS/Android trong .NET MAUI, Blazor WebAssembly | AOT trên iOS, interpreter/JIT trên WASM; dùng chung BCL |
| Native AOT | CLI, serverless, container cần khởi động nhanh | Biên dịch IL sang native lúc publish; không JIT, runtime CoreCLR rút gọn |
Đừng nói Mono đã chết. Nó vẫn là runtime của .NET cho iOS/Android trong .NET MAUI và của Blazor WebAssembly. Trên Windows, .NET dùng CoreCLR; trên iOS/Android dùng Mono — cùng BCL, khác engine.
Với framework-dependent deployment, máy đích phải có đúng major/minor runtime. Nếu thiếu minor, host có thể lăn về bản cao hơn (mặc định Minor), nhưng không nhảy major trừ khi bạn cấu hình rollForward. Đây là nguồn gốc của lỗi “app chạy trên máy dev nhưng không chạy trên server”.
SDK: bộ đồ nghề để build, không phải để chạy production
SDK là thứ bạn cài trên máy dev hoặc agent CI. Nó chứa:
- MSBuild — đọc
.csproj, chạy target, incremental build. - Roslyn — compiler C# và VB.NET, analyzer, source generator. F# có compiler riêng, không nằm trong Roslyn.
- NuGet client — restore,
PackageReference, lock file, central package management quaDirectory.Packages.props. - Template —
dotnet new list; cài template pack bằngdotnet new install. - Workload —
dotnet workload list; workload gắn với feature band của SDK nên phải chạydotnet workload updatesau khi nâng SDK. - CLI — toàn bộ lệnh
dotnet. - Build-time targets — apphost, single-file bundler, container publish (
PublishContainer), ILCompiler cho Native AOT. - Runtime — SDK cài kèm runtime tương ứng để chạy tool, test và
dotnet run.
SDK 10 build được net8.0 nhờ targeting pack, nhưng dotnet run ứng dụng net8.0 vẫn cần runtime 8 trên máy — build và chạy là hai điều kiện khác nhau. Trên server production, đừng cài SDK chỉ để chạy app: dotnet run build từ source và cần SDK; production nên chạy output đã publish bằng dotnet MyApp.dll hoặc apphost.
SDK version không phải runtime version. dotnet --version trả về SDK đang được chọn (dạng 10.0.1xx); dotnet --list-runtimes trả về runtime (10.0.14). Đừng so sánh hai con số này với nhau.
global.json: pin SDK, không pin runtime
Nếu không có global.json, dotnet dùng SDK cao nhất đã cài — trên CI, điều này làm build thay đổi theo thời gian. Pin feature band và cho phép patch đi lên:
{
"sdk": {
"version": "10.0.100",
"rollForward": "latestFeature",
"allowPrerelease": false
}
}
version phải là số đầy đủ; latestFeature cho phép feature band hoặc patch cao hơn trong cùng 10.0 (kể cả 10.0.2xx) nhưng không nhảy sang 11.x. Nếu muốn khóa chặt trong 10.0.1xx, dùng latestPatch. Đặt allowPrerelease: false vì ngoài Visual Studio giá trị mặc định là true — CI có thể chọn SDK RC nếu agent có bản đó. Tạo file bằng dotnet new globaljson --sdk-version 10.0.100 --roll-forward latestFeature.
Runtime và SDK cài side-by-side: nhiều bản nằm dưới C:\Program Files\dotnet\sdk trên Windows hoặc /usr/share/dotnet/sdk trên Linux. Một lưu ý thực tế: Visual Studio chỉ giữ một bản SDK và có thể gỡ bản cũ khi nâng cấp; nếu cần nhiều bản song song, cài SDK standalone thay vì qua Visual Studio Installer.
CLI: dotnet là cửa vào SDK, không phải runtime
dotnet là “generic driver” của .NET, có hai chức năng: chạy lệnh của SDK như new, build, test, publish; và chạy ứng dụng đã biên dịch khi bạn truyền file .dll. Cùng một file thực thi, hai đường đi khác nhau:
dotnet build→ host tìm SDK (theoglobal.json), nạp MSBuild/Roslyn. Cần SDK, không cần runtime của app.dotnet MyApp.dll→ host đọcruntimeconfig.json, nạp runtime và chạy app. Không cần SDK.dotnet run→ SDK build trước, sau đó host chạy output. Cần cả hai.
Vì vậy câu “cài .NET” phải hỏi lại: cài runtime để chạy, hay cài SDK để build? Máy dev cần SDK; server cần runtime hoặc image runtime; CI cần SDK đúng version trong global.json.
Năm lệnh kiểm tra môi trường
| Lệnh | Trả lời câu hỏi |
|---|---|
dotnet --info |
SDK đang dùng, đường dẫn, OS, kiến trúc, danh sách runtime |
dotnet --list-sdks |
Những SDK đã cài và feature band |
dotnet --list-runtimes |
CoreCLR, ASP.NET Core và Desktop runtime đã cài |
dotnet new list |
Template khả dụng: console, webapi, webapiaot, maui… |
dotnet workload list |
Workload đã cài cho SDK hiện tại |
Vòng đời phiên bản: LTS, STS và lý do production chọn LTS
.NET phát hành major mỗi tháng 11. Số chẵn là LTS, số lẻ là STS. LTS được hỗ trợ 3 năm; STS 2 năm — chính sách hiện hành, không còn là 18 tháng như các bản .NET 5/7 trước đây.
| Phiên bản | Loại | Hỗ trợ đến |
|---|---|---|
| .NET 11 (11.0.0-rc.3) | STS | GA dự kiến 11/2026; 2 năm sau GA |
| .NET 10 (10.0.14) | LTS | 14/11/2028 |
| .NET 9 (9.0.22) | STS | 10/11/2026 |
| .NET 8 (8.0.33) | LTS | 10/11/2026 |
| .NET Framework 4.8.1 | Thành phần Windows | Theo vòng đời Windows |
.NET 8 và .NET 9 hết hỗ trợ ngày 10/11/2026. Sau ngày đó không còn bản vá bảo mật; container vẫn chạy nhưng image scanner sẽ báo CVE không thể vá. Nếu service của bạn còn target net8.0 hoặc net9.0, việc nâng lên net10.0 nên đứng trước mọi kế hoạch học tập khác.
LTS không “ổn định hơn” về chất lượng code — cùng một quy trình phát hành. Khác biệt là thời hạn: với LTS bạn có 3 năm để lên kế hoạch nâng cấp, với STS là 2 năm. Production cần thời gian migration, vá bảo mật và hỗ trợ từ cloud vendor; vì vậy baseline nên là LTS. .NET 11 GA tháng 11/2026 là STS: có thể pilot, nhưng đừng đặt nó làm chuẩn cho hệ thống sống 3 năm. .NET 12 LTS dự kiến tháng 11/2027.
Nâng cấp thực tế: net8.0 → net10.0 thường ít đau hơn đi qua net9.0, vì API và tooling đã ổn định; nhưng vẫn phải chạy lại toàn bộ test, kiểm tra package 10.x, cập nhật CI và image base tag 10.0.
Lịch sử ngắn: .NET Framework, .NET Core và Mono
Ba nhánh này giải thích phần lớn nhầm lẫn còn lại.
- .NET Framework (từ 2002) chạy trên Windows với CLR riêng, không cross-platform. Bản mới nhất là 4.8.1 (2022), được hỗ trợ như một thành phần của Windows nhưng không có tính năng mới. Nó vẫn tồn tại vì ứng dụng WinForms/WPF và thư viện cũ, không phải vì là lựa chọn cho dự án mới.
- .NET Core (1.0 năm 2016) viết lại cross-platform, mã nguồn mở, cài side-by-side. .NET Core 3.1 là LTS nhưng đã hết hỗ trợ từ tháng 12/2022 — không phải bản hiện tại.
- .NET 5 (2020) bỏ chữ “Core” để thống nhất thương hiệu và đánh số 5 nhằm tránh nhầm với .NET Framework 4.x. Từ đó là nhịp phát hành hàng năm: 6 LTS, 7 STS, 8 LTS, 9 STS, 10 LTS, 11 STS.
- Mono (2001) là nhánh runtime cross-platform ban đầu, sau đó được thương mại hóa thành Xamarin cho mobile. Xamarin.Forms hết hỗ trợ ngày 1/5/2024; successor là .NET MAUI. Mono vẫn còn trong MAUI (iOS/Android) và Blazor WebAssembly.
Kết luận thực dụng: hệ sinh thái .NET hôm nay là .NET 10 + NuGet + workload/template + tooling; .NET Framework là nhánh bảo trì cho Windows; Mono là chi tiết triển khai bên trong MAUI/WASM, không phải nền tảng bạn cài riêng.
Sáu sai lầm thường gặp
1. Chỉ cài runtime trên máy dev. dotnet build báo không tìm thấy SDK. Runtime đủ để chạy app đã publish, không đủ để biên dịch. Cài SDK.
2. Cài SDK trên máy dev rồi cho rằng server cũng có runtime. Publish framework-dependent xong, app chết với “You must install .NET”. Chọn self-contained, cài runtime, hoặc dùng base image mcr.microsoft.com/dotnet/aspnet:10.0.
3. Ép self-contained cho mọi service. Image lớn hơn, deploy lâu hơn, và mỗi CVE runtime phải build lại từng app. Trong container, framework-dependent trên base image aspnet:10.0 là mặc định hợp lý; chỉ self-contained khi môi trường đích không kiểm soát được runtime.
4. Bật Native AOT cho app MVC hoặc Blazor Server. AOT không hỗ trợ MVC, Blazor Server, OData, Session, SPA; SignalR chỉ hỗ trợ một phần. Nó phù hợp với minimal API, gRPC và worker. Bật AOT cho app không tương thích sẽ nhận warning trim/AOT và lỗi runtime.
5. Không có global.json. CI lấy SDK mới nhất, máy dev lấy bản khác, build “pass trên máy tôi” nhưng fail trên pipeline. Pin feature band và bật allowPrerelease: false.
6. Chạy dotnet run trên production. Lệnh này build từ source và cần SDK; nó còn làm chậm khởi động và che giấu lỗi publish. Production chạy dotnet MyApp.dll, apphost, hoặc container image.
Chọn mô hình triển khai trong 2026
SDK 10 publish được cả năm mô hình dưới đây từ cùng một project. Chọn theo ràng buộc môi trường đích.
| Mô hình | Máy đích cần | Chọn khi |
|---|---|---|
| Framework-dependent | Runtime hoặc base image aspnet | Web/API trong container; image nhỏ, vá runtime tập trung |
| Self-contained | Không cần runtime | Server không kiểm soát, app desktop/CLI; đổi lại image lớn |
| Single-file | Không cần runtime (bản self-contained) | Công cụ CLI muốn một file; lưu ý Assembly.Location trả về chuỗi rỗng |
| Native AOT | Không cần runtime | Cold start, scale-to-zero, mật độ instance cao; minimal API/gRPC/worker |
| Container từ SDK | Container runtime hoặc registry | CI không muốn Dockerfile; PublishContainer tạo image OCI |
# Framework-dependent (mặc định)
dotnet publish -c Release
# Self-contained cho Linux x64
dotnet publish -c Release -r linux-x64 --self-contained true
# Single-file, self-contained
dotnet publish -c Release -r linux-x64 --self-contained true -p:PublishSingleFile=true
# Container image không cần Dockerfile
dotnet publish --os linux --arch x64 /t:PublishContainer
Với Native AOT, bật trong project file rồi publish theo RID:
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
<PublishAot>true</PublishAot>
</PropertyGroup>
dotnet publish -c Release -r linux-x64
Native AOT biên dịch IL sang native lúc publish, không JIT khi chạy; binary chứa runtime CoreCLR rút gọn và không cần cài .NET trên máy đích. Giới hạn cần biết: không load assembly động (Assembly.LoadFile), không Reflection.Emit, không C++/CLI, không built-in COM trên Windows; bắt buộc trimming nên thư viện dùng reflection có thể hỏng; phải publish trên OS đích vì không cross-compile. Với ASP.NET Core, JSON phải dùng source generator (JsonSerializerContext) và chỉ minimal API, gRPC, worker là những loại app AOT hỗ trợ. Với CLI, serverless hoặc service cần khởi động tức thì, AOT đáng giá; với app MVC nhiều reflection, JIT + ReadyToRun là lựa chọn thực tế hơn.
Checklist môi trường .NET 10
- Chạy
dotnet --infovà lưu lại SDK, runtime, kiến trúc. Đây là dữ liệu đầu tiên khi debug build hoặc deploy. - Thêm
global.jsonpin10.0.100vớirollForward: latestFeaturevàallowPrerelease: false. - Đổi TFM sang
net10.0, cập nhật package lên bản10.xtương ứng, chạy lại test và benchmark nếu có. - Trên CI, cài SDK 10.0.x, chạy
dotnet workload restorenếu repo dùng MAUI/Aspire, và restore với--locked-modenếu có lock file. - Chọn mô hình deploy cho từng service: framework-dependent trong container, self-contained cho agent, AOT cho service nhạy cold start.
- Gỡ .NET 8/9 khỏi build agent trước 10/11/2026 để không build nhầm target đã hết hỗ trợ.
Nhìn sang 2027
.NET 11 GA tháng 11/2026 (STS), .NET 12 LTS tháng 11/2027. Chu kỳ 12 tháng nghĩa là mỗi năm có một cửa sổ nâng cấp; đội nào coi nâng cấp .NET là dự án riêng sẽ luôn chậm một nhịp. Giữ baseline LTS, pilot STS sớm, và theo dõi hai hướng đang thay đổi cách đóng gói: container publish từ SDK và Native AOT cho service cần mật độ cao.
Bài tiếp theo
- Làm chủ .NET CLI — các lệnh hằng ngày, file-based app,
dnx, local tool. - C# cho lập trình viên ASP.NET Core — C# 14, async/await, LINQ, nullable.
- Docker hóa ứng dụng ASP.NET Core — Dockerfile, multi-stage, image runtime.
- ASP.NET Core Roadmap 2026 — thứ tự học và toàn bộ series.



