Tài liệu setup môi trường phát triển C# WinForms trên Windows

Tài liệu này hướng dẫn cài đặt và kiểm tra đầy đủ môi trường phát triển ứng dụng C# WinForms trên Windows với .NET 10, Visual Studio 2026 và SQL Server 2025.

1. Cài đặt .NET SDK

Tải và cài đặt .NET SDK 10.0.400 (x64) từ trang chính thức của Microsoft:

Tải .NET 10 SDK
Chọn bản SDK x64 dành cho Windows.

Sau khi cài đặt, mở PowerShell, Command Prompt hoặc Windows Terminal và chạy:

dotnet --version

Kết quả mong đợi:

10.0.400

Có thể kiểm tra toàn bộ SDK đã cài bằng lệnh:

dotnet --list-sdks

Nếu lệnh dotnet chưa được nhận diện, hãy đóng rồi mở lại terminal hoặc khởi động lại Windows để biến môi trường PATH được cập nhật.

2. Cài đặt Visual Studio 2026

Tải Visual Studio từ trang chính thức:

Tải Visual Studio

Trong Visual Studio Installer, chọn workload:

.NET Desktop Development

Ở phần chi tiết cài đặt, bảo đảm các thành phần cần thiết cho .NET 10 và Windows Forms đã được chọn. Sau khi cài xong, mở Visual Studio và đăng nhập nếu tổ chức yêu cầu.

3. Cài đặt Git for Windows

Tải phiên bản Git for Windows mới nhất:

Tải Git

Có thể giữ các tùy chọn mặc định trong trình cài đặt nếu dự án không có quy định riêng. Sau khi hoàn tất, mở terminal và kiểm tra:

git --version

Lệnh phải trả về phiên bản Git đã cài, ví dụ:

git version 2.x.x.windows.x

Nên cấu hình tên và email cho Git trước khi tạo commit:

git config --global user.name "Tên của bạn"
git config --global user.email "email@yopaz.vn"

4. Cài đặt SQL Server 2025

Tải bộ cài SQL Server 2025 từ Microsoft:

Tải SQL Server 2025

Thực hiện theo trình cài đặt và ghi lại các thông tin sau để dùng khi kết nối:

Tên SQL Server instance.
Chế độ xác thực.
Tài khoản quản trị, nếu sử dụng SQL Server Authentication.
Mật khẩu đã thiết lập.
Cổng kết nối, nếu dùng cấu hình riêng.

Với môi trường phát triển cá nhân, có thể sử dụng cấu hình mặc định phù hợp với quy định của dự án.

5. Cài đặt SQL Server Management Studio 22

SSMS là công cụ quản trị và truy vấn SQL Server. Tải SQL Server Management Studio Version 22 tại:

Hướng dẫn cài đặt SSMS

Sau khi cài đặt:

Mở SSMS 22.
Nhập tên server hoặc instance đã tạo ở bước trước.
Chọn phương thức xác thực phù hợp.
Nhấn Connect.
Mở một cửa sổ truy vấn mới và chạy:

SELECT @@VERSION;

Nếu truy vấn trả về thông tin phiên bản SQL Server, kết nối đã hoạt động bình thường.

6. Kiểm tra toàn bộ môi trường

Trước khi bắt đầu phát triển, bảo đảm các thành phần sau đã sẵn sàng:

.NET SDK 10.0.400 (x64).
Visual Studio 2026.
Workload .NET Desktop Development.
Git for Windows.
SQL Server 2025.
SQL Server Management Studio 22.
SSMS kết nối được tới SQL Server.

Kiểm tra nhanh .NET và Git bằng PowerShell:

dotnet --version
git --version

Nếu dự án sử dụng Git qua SSH hoặc HTTPS, hãy kiểm tra thêm thông tin đăng nhập và quyền truy cập repository trước khi làm việc.

7. Tạo project C# WinForms

Thực hiện các bước sau trong Visual Studio 2026:

Mở Visual Studio 2026.
Chọn Create a new project.
Tìm và chọn template Windows Forms App.
Nhấn Next.
Nhập tên project và chọn thư mục lưu mã nguồn.
Ở mục Framework, chọn .NET 10.
Nhấn Create.
Khi cửa sổ thiết kế Form1 xuất hiện, nhấn F5 để build và chạy thử.

Nếu cửa sổ WinForms mặc định hiển thị mà không có lỗi, môi trường phát triển cơ bản đã được thiết lập thành công.

Xử lý một số lỗi thường gặp

Không thấy template Windows Forms App

Mở Visual Studio Installer, chọn Modify tại phiên bản Visual Studio đang dùng, sau đó cài workload .NET Desktop Development.

Không thấy .NET 10 trong danh sách Framework

Kiểm tra lại SDK bằng:

dotnet --list-sdks

Nếu không có phiên bản 10.0.400, hãy cài lại .NET SDK x64 và khởi động lại Visual Studio.

Không kết nối được SQL Server

Kiểm tra:

Dịch vụ SQL Server đã chạy hay chưa.
Tên server/instance có chính xác không.
Phương thức xác thực và thông tin đăng nhập.
Cấu hình mạng, cổng kết nối và Windows Firewall.

Hoàn tất

Sau khi project mẫu chạy thành công và SSMS kết nối được tới SQL Server 2025, máy Windows đã sẵn sàng để phát triển ứng dụng C# WinForms trên .NET 10.