Để chạy code C# trên máy, bạn cần hai thứ: .NET SDK (bộ công cụ biên dịch và chạy code) và một trình soạn thảo. Trang này dùng .NET 8 và VS Code, cài xong mất khoảng mười phút.
Cài .NET 8 SDK
Chỗ người mới hay tải nhầm là bản Runtime thay vì SDK. Runtime chỉ để chạy chương trình người khác đã build sẵn, không có trình biên dịch. Bạn cần SDK.
- Vào trang tải chính thức của Microsoft:
dotnet.microsoft.com/download. - Chọn .NET 8.0, cột SDK, bản cho hệ điều hành của bạn (Windows x64, macOS Arm64 cho máy Mac chip M, hoặc Linux).
- Chạy file cài, bấm Next tới hết.
Cài xong, mở một cửa sổ terminal mới (PowerShell trên Windows, Terminal trên macOS) và gõ:
dotnet --version
Nếu hiện ra một số bắt đầu bằng 8. (ví dụ 8.0.400) là xong. Máy có cài bản mới hơn như 9.0 cũng được, SDK mới vẫn build được code C# 12.
Cài VS Code và C# Dev Kit
- Tải VS Code tại
code.visualstudio.comvà cài như phần mềm bình thường. - Mở VS Code, bấm biểu tượng Extensions ở thanh bên trái (hoặc
Ctrl+Shift+X). - Tìm C# Dev Kit của Microsoft, bấm Install. Nó tự cài kèm extension C#.
C# Dev Kit cho bạn gợi ý code khi gõ, gạch đỏ chỗ sai, và nút chạy chương trình. Không có nó, VS Code chỉ là trình soạn thảo chữ.
Tạo project đầu tiên
Mở terminal, đi tới thư mục bạn muốn để code, rồi gõ:
dotnet new console -o SlimeHunter
cd SlimeHunter
code .
dotnet new consoletạo một project chạy trong cửa sổ dòng lệnh.-o SlimeHunterđặt tên thư mục và tên project.code .mở thư mục hiện tại bằng VS Code.
Trong thư mục sẽ có hai file đáng chú ý:
SlimeHunter.csproj: file cấu hình project. Chưa cần sửa.Program.cs: nơi bạn viết code.
Mở Program.cs, bạn thấy đúng một dòng:
// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");
Chạy chương trình
Trong terminal (VS Code có terminal riêng, mở bằng Ctrl+`), gõ:
dotnet run
Kết quả:
Hello, World!
Giờ thử sửa Program.cs thành code của bạn, lưu file, rồi dotnet run lại:
string heroName = "Aki";
int level = 1;
Console.WriteLine(heroName + " bắt đầu ở level " + level); // Aki bắt đầu ở level 1
Lần chạy đầu chậm vài giây vì .NET phải build. Các lần sau nhanh hơn.
Lỗi hay gặp: gõ
dotnetthì terminal báo'dotnet' is not recognized as an internal or external command(Windows) hoặccommand not found: dotnet(macOS, Linux). Có ba nguyên nhân thường gặp:
- Terminal được mở trước khi cài SDK nên chưa biết đường dẫn mới. Đóng hẳn terminal và VS Code, mở lại.
- Bạn cài nhầm bản Runtime. Chạy
dotnet --list-sdks, nếu không ra dòng nào thì cài lại bản SDK.- Trên Windows, thư mục
C:\Program Files\dotnet\chưa nằm trong biến môi trườngPATH. Khởi động lại máy thường là đủ. Nếu vẫn chưa được, thêm thư mục đó vàoPATHbằng tay.
Lỗi chạy sai thư mục
Một lỗi khác cũng hay gặp: gõ dotnet run và nhận Couldn't find a project to run. Nghĩa là terminal đang đứng ở thư mục không có file .csproj. Gõ cd SlimeHunter để vào đúng thư mục rồi chạy lại.
Có project chạy được rồi thì sang trang cú pháp C# để hiểu từng dòng code.
Bài tập
Tạo một project mới tên GoldCounter, sửa Program.cs để in ra dòng Vàng: 250, rồi chạy nó.
Xem đáp án
Trong terminal:
dotnet new console -o GoldCounter
cd GoldCounter
Nội dung Program.cs:
int gold = 250;
Console.WriteLine("Vàng: " + gold); // Vàng: 250
Rồi chạy dotnet run.