Sunday, June 7, 2026
GitHubTwitter
Development

Debug ASP.NET Core trên VS Code: Hướng dẫn chi tiết từ A-Z

Ginbok5 phút đọc

Visual Studio Code là trình soạn thảo nhẹ nhưng mạnh mẽ, hỗ trợ đầy đủ gỡ lỗi từng bước (step-by-step debugging) cho các ứng dụng ASP.NET Core. Với thiết lập chính xác, bạn có thể gỡ lỗi các controllers, services, middleware và Web APIs giống hệt như khi sử dụng Visual Studio.

Hướng dẫn này sẽ trình bày mọi thứ bạn cần biết, từ các điều kiện tiên quyết cho đến các kịch bản gỡ lỗi nâng cao.

1. Điều kiện tiên quyết

Trước khi gỡ lỗi ASP.NET Core trong VS Code, hãy đảm bảo bạn đã cài đặt những thứ sau:

1.1 Cài đặt .NET SDK

Bạn phải cài đặt .NET SDK, không chỉ runtime.

Xác minh việc cài đặt:

dotnet --version 

1.2 Cài đặt Visual Studio Code

Tải xuống và cài đặt phiên bản mới nhất của Visual Studio Code.

1.3 Cài đặt Extension C#

Trong VS Code, hãy cài đặt:

  • C# Dev Kit (Microsoft)
    Extension này bao gồm OmniSharp và hỗ trợ gỡ lỗi cho .NET.

2. Mở Project ASP.NET Core của Bạn

Mở thư mục gốc của project ASP.NET Core trong VS Code (thư mục chứa tệp .csproj).

Nếu đây là lần đầu tiên bạn mở một project C#, VS Code sẽ yêu cầu khôi phục các dependency — hãy chấp nhận.

3. Tạo Cấu hình Gỡ lỗi (launch.json)

3.1 Tự động tạo launch.json

  1. Mở panel Run & Debug (Ctrl + Shift + D)

  2. Nhấp vào Create a launch.json file

  3. Chọn .NET Core

  4. Chọn ASP.NET Core

VS Code sẽ tạo ra tệp .vscode/launch.json.

3.2 Cấu hình launch.json mẫu

 
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "ASP.NET Core",
      "type": "coreclr",
      "request": "launch",
      "preLaunchTask": "build",
      "program": "${workspaceFolder}/bin/Debug/net8.0/YourProject.dll",
      "args": [],
      "cwd": "${workspaceFolder}",
      "stopAtEntry": false,
      "serverReadyAction": {
        "action": "openExternally",
        "pattern": "\\bNow listening on:\\s+(https?://\\S+)"
      },
      "env": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  ]
}

⚠️ Đảm bảo rằng:

  • net8.0 khớp với framework mục tiêu của project bạn

  • YourProject.dll khớp với tên project của bạn

4. Đặt Breakpoint

Mở bất kỳ tệp C# nào và nhấp vào bên cạnh số dòng để đặt breakpoint.

Ví dụ trong một controller:

 
[HttpGet("{id}")] public IActionResult GetUser(int id) { var user = _userService.GetById(id); // breakpoint here return Ok(user); }

Breakpoints có thể được đặt tại:

  • Controllers

  • Services

  • Repositories

  • Middleware

  • Minimal API endpoints

5. Bắt đầu Gỡ lỗi

Nhấn F5 hoặc nhấp vào Start Debugging.

VS Code sẽ:

  • Build project

  • Khởi chạy ứng dụng ASP.NET Core

  • Tự động mở trình duyệt (nếu đã cấu hình)

Kích hoạt yêu cầu API bằng cách sử dụng:

  • Trình duyệt

  • Swagger UI

  • Postman

  • Ứng dụng Frontend

Khi yêu cầu chạm tới breakpoint của bạn, quá trình thực thi sẽ tạm dừng.

6. Các Điều khiển Gỡ lỗi Từng bước

Trong khi tạm dừng, bạn có thể sử dụng:

  • Step Over (F10) – thực thi dòng tiếp theo

  • Step Into (F11) – đi vào bên trong một phương thức

  • Step Out (Shift + F11) – thoát khỏi phương thức hiện tại

  • Continue (F5) – tiếp tục thực thi

Bạn cũng có thể kiểm tra:

  • Biến cục bộ (Local variables)

  • Tham số (Parameters)

  • Ngăn xếp Cuộc gọi (Call Stack)

  • Biểu thức Theo dõi (Watch expressions)

7. Gỡ lỗi Web APIs

VS Code hoạt động hoàn hảo để gỡ lỗi Web APIs.

Quy trình làm việc điển hình:

  1. Bắt đầu gỡ lỗi với F5

  2. Mở Swagger hoặc Postman

  3. Gửi yêu cầu HTTP

  4. Breakpoint được kích hoạt

  5. Kiểm tra dữ liệu yêu cầu và logic từng bước

Điều này đặc biệt hữu ích cho:

  • Các vấn đề Xác thực / Ủy quyền (Authentication / Authorization)

  • Xác thực logic nghiệp vụ (Business logic validation)

  • Gỡ lỗi tương tác với Cơ sở dữ liệu

8. Gắn Debugger vào Ứng dụng đang Chạy (Attach)

Nếu ứng dụng của bạn đã chạy bằng lệnh:

 
dotnet run

Bạn vẫn có thể gỡ lỗi nó:

  1. Mở Run & Debug

  2. Chọn .NET Core Attach

  3. Chọn tiến trình dotnet chính xác

Tính năng này hữu ích cho:

  • Docker containers

  • Các dịch vụ nền (Background services)

  • Các tiến trình chạy dài (Long-running processes)

9. Các Vấn đề Thường gặp và Khắc phục

Breakpoint không được kích hoạt

  • Đảm bảo bạn đang chạy ở chế độ Debug, không phải Release

  • Kiểm tra đường dẫn program trong launch.json là chính xác

  • Clean và rebuild lại project

OmniSharp không hoạt động

  • Khởi động lại OmniSharp (Ctrl + Shift + P → Restart OmniSharp)

  • Đảm bảo chỉ có một .NET SDK đang hoạt động

10. VS Code so với Visual Studio

VS Code lý tưởng khi bạn:

  • Xây dựng Web APIs

  • Làm việc với microservices

  • Thích trình soạn thảo nhẹ (lightweight)

  • Sử dụng phát triển đa nền tảng (cross-platform)

Visual Studio có thể tốt hơn khi bạn:

  • Làm việc nhiều với Razor Pages

  • Sử dụng các công cụ EF nâng cao

  • Ưu tiên scaffolding dựa trên GUI

Kết luận

Visual Studio Code cung cấp hỗ trợ gỡ lỗi từng bước đầy đủ cho ASP.NET Core. Với các breakpoint, kiểm tra biến và gỡ lỗi API, đây là một lựa chọn mạnh mẽ cho phát triển .NET hiện đại—đặc biệt đối với các dự án backend và Web API.

Nếu bạn ưu tiên tốc độ, tính linh hoạt và hỗ trợ đa nền tảng, VS Code là một lựa chọn tuyệt vời để gỡ lỗi ASP.NET Core.

#VSCode#ASPNETCore#Debugging#DotNet#CSharp#Development#ProgrammingTips#CodeEditor
← Quay lại bài viết