Apidog

Nền tảng phát triển API hợp tác tất cả trong một

Thiết kế API

Tài liệu API

Gỡ lỗi API

Giả lập API

Kiểm thử API tự động

Cách Cài Đặt Con Trỏ: Hướng Dẫn Dành Cho Người Mới Bắt Đầu

中村 拓也

中村 拓也

Updated on tháng 4 3, 2025

Các công cụ được hỗ trợ bởi AI đang biến đổi phát triển phần mềm, giúp lập trình trở nên dễ dàng hơn cho các nhà phát triển ở mọi cấp độ kỹ năng. Cursor đang tiên phong trong sự chuyển mình này, cung cấp một môi trường lập trình trực quan được nâng cao bởi AI. Khác với các trình soạn thảo mã truyền thống, Cursor không chỉ cung cấp một không gian để viết mã - nó còn tích cực hỗ trợ bạn trong suốt quá trình phát triển.

Xây dựng trên nền tảng quen thuộc của VS Code, Cursor dễ dàng sử dụng cho cả người mới bắt đầu và các nhà phát triển dày dạn kinh nghiệm. Điều làm cho nó trở nên độc đáo là sự tích hợp với các mô hình AI tiên tiến như Claude 3.5 Sonnet, cho phép bạn viết, sửa đổi và hiểu mã bằng cách sử dụng các hướng dẫn bằng ngôn ngữ tự nhiên.

Trước khi khám phá phép màu AI của Cursor, đây là một sự thay đổi cuộc chơi cho quy trình làm việc API:
Tích hợp máy chủ Apidog MCP để cung cấp cho Cursor quyền truy cập trực tiếp vào các thông số API của bạn. Cặp đôi năng động này:

✔ Tạo mã khách hàng API chính xác phù hợp với tài liệu của bạn (không còn sao chép và dán thủ công nữa!)
✔ Đề xuất tự động các điểm cuối, tham số và xác thực khi bạn gõ - như Copilot nhưng dành cho API
✔ Giữ cho mã đồng bộ với các thay đổi của API để tránh những bất ngờ "chạy trên máy của tôi"

Psst… Cuộn xuống phần "Nâng cao Cursor với máy chủ Apidog MCP" để thiết lập điều này trong 5 phút!

button

Tại sao Cursor lại là một sự thay đổi cuộc chơi?

Đối với người mới, Cursor loại bỏ nhu cầu phải làm chủ cú pháp phức tạp hoặc ghi nhớ các quy tắc lập trình. Chỉ cần mô tả những gì bạn muốn, và Cursor sẽ tạo ra mã cho bạn. Điều này làm giảm rào cản gia nhập, cho phép các nhà phát triển mới tập trung vào sự sáng tạo và giải quyết vấn đề thay vì phải vật lộn với các chi tiết kỹ thuật.

Nhưng Cursor không chỉ dành cho người mới bắt đầu - nó là một công cụ mạnh mẽ cho tất cả các nhà phát triển. Nó có thể:

  • Phân tích mã và giải thích nó bằng tiếng Anh đơn giản
  • Đề xuất cải tiến để đạt hiệu suất và độ đọc tốt hơn
  • Gỡ lỗi lỗi bằng cách xác định và sửa chữa các vấn đề
  • Tạo toàn bộ dự án dựa trên các mô tả mức cao
  • Thực hiện các tính năng khi bạn mô tả những gì bạn cần

Điều này khiến Cursor hữu ích cho mọi thứ từ các kịch bản đơn giản đến ứng dụng web, ứng dụng di động và tiện ích mở rộng trình duyệt. Dù bạn đang viết chương trình "Hello World" đầu tiên hay xây dựng một dự án phức tạp, Cursor cung cấp hỗ trợ do AI điều khiển để hiện thực hóa những ý tưởng của bạn.

Khi chúng ta đi qua quy trình thiết lập, hãy nhớ rằng Cursor hơn cả một công cụ - nó là một cách mới để lập trình, kết hợp sáng tạo của con người với hiệu suất của AI để mở ra những khả năng từng chỉ giới hạn cho các nhà phát triển chuyên gia.

Cài đặt Cursor: Bước đầu tiên để thiết lập lập trình được nâng cao bởi AI

Thiết lập Cursor trên hệ thống của bạn là một quá trình đơn giản yêu cầu kiến thức kỹ thuật tối thiểu. Phần này sẽ hướng dẫn bạn từng bước của quá trình cài đặt, đảm bảo bạn có thể nhanh chóng bắt đầu hành trình lập trình được hỗ trợ bởi AI.

Yêu cầu hệ thống và tính tương thích

Trước khi tải xuống Cursor, hãy đảm bảo hệ thống của bạn đáp ứng các yêu cầu cơ bản:

  • Hệ điều hành: Windows 10/11, macOS hoặc Linux
  • Bộ nhớ: Ít nhất 500MB không gian đĩa trống
  • Bộ nhớ RAM: Tối thiểu 4GB RAM (8GB trở lên được khuyên dùng cho hiệu suất tối ưu)
  • Kết nối Internet: Cần thiết cho các tính năng AI vì chúng hoạt động qua dịch vụ đám mây

Cursor được thiết kế để hoạt động trên nhiều nền tảng, giúp nó dễ dàng truy cập bất kể hệ điều hành bạn ưu tiên. Quá trình cài đặt có một số khác biệt nhỏ giữa các hệ thống, nhưng chức năng cốt lõi vẫn nhất quán.

Quá trình tải xuống và cài đặt

1. Truy cập trang web chính thức: Điều hướng tới cursor.com bằng trình duyệt web bạn ưa thích.

tải xuống cursor

2. Tải xuống phiên bản phù hợp: Trên trang tải xuống, chọn phiên bản phù hợp với hệ điều hành của bạn. Trang web sẽ tự động phát hiện hệ thống của bạn và đề xuất phiên bản chính xác.

3. Chạy trình cài đặt: Khi tải xong, tìm tệp trình cài đặt trong thư mục tải xuống của bạn và chạy nó.

  • Trên Windows: Nhấp đúp vào tệp .exe và làm theo hướng dẫn trên màn hình
  • Trên macOS: Mở tệp .dmg, kéo Cursor vào thư mục Ứng dụng của bạn
  • Trên Linux: Làm cho AppImage có thể thực thi và chạy nó, hoặc sử dụng các lệnh trình quản lý gói được cung cấp

4. Hoàn tất trình hướng dẫn thiết lập: Trình cài đặt sẽ hướng dẫn bạn thông qua một loạt bước đơn giản. Trong hầu hết các trường hợp, chấp nhận các tùy chọn mặc định là đủ, nhưng bạn có thể tùy chỉnh các đường dẫn cài đặt nếu cần thiết.

5. Cấu hình lần đầu tiên: Khi bạn lần đầu mở Cursor, bạn sẽ được yêu cầu tạo tài khoản hoặc đăng nhập. Tạo tài khoản là miễn phí và cho bạn quyền truy cập vào thử nghiệm 14 ngày cho các tính năng Pro mà không cần thông tin thanh toán.

6. Nhập cài đặt hiện có (Tùy chọn): Nếu bạn đã sử dụng VS Code trước đó, Cursor sẽ đề nghị nhập các cài đặt, tiện ích mở rộng và sở thích của bạn. Tùy chọn này có thể giúp chuyển tiếp mượt mà nếu bạn đã quen thuộc với VS Code.

Cấu hình ban đầu và sở thích

Sau khi cài đặt, hãy dành chút thời gian để cấu hình Cursor theo sở thích của bạn:

1. Lựa chọn chủ đề: Chọn một chủ đề hình ảnh phù hợp với phong cách làm việc của bạn. Cursor cung cấp chế độ sáng và tối, cùng với nhiều bảng màu khác nhau.

2. Tùy chỉnh phông chữ: Điều chỉnh kích thước và kiểu phông chữ để đảm bảo mã được đọc dễ dàng. Điều này đặc biệt quan trọng nếu bạn có kế hoạch dành thời gian dài để lập trình.

3. Phím tắt: Xem xét các phím tắt mặc định hoặc tùy chỉnh chúng để phù hợp với quy trình làm việc của bạn. Các phím tắt quan trọng nhất bao gồm:

  • Ctrl+K/Cmd+K: Chỉnh sửa AI trực tuyến
  • Ctrl+L/Cmd+L: Chuyển đổi bảng trò chuyện AI
  • Tab: Chấp nhận các gợi ý mã AI

4. Tiện ích mở rộng: Duyệt và cài đặt các tiện ích mở rộng cải thiện trải nghiệm phát triển của bạn. Vì Cursor được xây dựng trên VS Code, nhiều tiện ích mở rộng của VS Code cũng tương thích.

5. Cài đặt AI: Cấu hình các cài đặt specifiek cho AI như hành vi tự động hoàn thành và sở thích lập chỉ mục mã. Những cài đặt này xác định mức độ chủ động của AI trong việc đề xuất mã khi bạn gõ.

Bằng cách dành thời gian thiết lập đúng cách và cấu hình Cursor, bạn tạo ra một môi trường theo nhu cầu của bạn, tối đa hóa cả sự thoải mái và năng suất khi bạn bắt đầu khám phá các tính năng mạnh mẽ của AI làm cho Cursor trở nên độc đáo trong lĩnh vực lập trình.

Điều hướng giao diện Cursor: Thiết lập thiết yếu cho lập trình hiệu quả

Hiểu giao diện của Cursor là rất quan trọng để tận dụng tối đa tiềm năng của nó. Bố cục kết hợp các yếu tố của trình soạn thảo mã quen thuộc với các tính năng AI đổi mới, tạo ra một không gian làm việc cân bằng giữa lập trình truyền thống với sự hỗ trợ của AI. Phần này khám phá các thành phần chính của giao diện và cách điều hướng chúng một cách hiệu quả.

Cửa sổ chỉnh sửa chính và quản lý tệp

Trình chỉnh sửa Cursor

Khu vực trung tâm của Cursor là cửa sổ chỉnh sửa, nơi bạn sẽ dành phần lớn thời gian để viết và chỉnh sửa mã. Không gian này hoạt động tương tự như các trình soạn thảo mã khác, với đánh dấu cú pháp, số dòng và nhiều tab để làm việc với nhiều tệp cùng lúc.

Để bắt đầu một dự án mới:

  1. Chọn Tệp > Mở Thư mục (hoặc sử dụng Ctrl+Shift+P và gõ "Mở Thư mục")
  2. Chọn một thư mục trống hoặc một thư mục dự án hiện có
  3. Cấu trúc thư mục sẽ hiển thị trong bảng Explorer ở bên trái

Bảng Explorer cung cấp một cái nhìn phân cấp về các tệp và thư mục dự án của bạn. Nhấp chuột phải vào khu vực này sẽ hiện ra các tùy chọn để tạo, đổi tên và xóa tệp - những thao tác thiết yếu để tổ chức mã của bạn. Đối với người mới bắt đầu, việc tạo một cấu trúc thư mục hợp lý từ đầu sẽ giúp duy trì tổ chức khi các dự án của bạn phát triển về độ phức tạp.

Khi làm việc với nhiều tệp, Cursor cho phép bạn chia cửa sổ chỉnh sửa theo chiều ngang hoặc chiều dọc, cho phép so sánh và chỉnh sửa cạnh nhau. Tính năng này đặc biệt hữu ích khi triển khai các tính năng trải dài qua nhiều tệp hoặc khi tham khảo tài liệu trong khi lập trình.

Cursor cho phép bạn chia cửa sổ chỉnh sửa theo chiều ngang hoặc chiều dọc

Bảng trò chuyện AI: Trợ lý lập trình của bạn

Bảng trò chuyện AI, thường nằm ở bên phải của giao diện, hoạt động như một kênh liên lạc trực tiếp của bạn với trợ lý AI của Cursor. Nếu không hiển thị theo mặc định, bạn có thể chuyển đổi nó bằng cách sử dụng Ctrl+L (Cmd+L trên Mac).

Giao diện trò chuyện giống như một ứng dụng nhắn tin, với các truy vấn của bạn ở dưới cùng và các phản hồi của AI ở phía trên. Cách tiếp cận đối thoại này làm cho các nhiệm vụ lập trình phức tạp trở nên dễ tiếp cận hơn, đặc biệt với những người mới bắt đầu có thể chưa thành thạo cú pháp lập trình.

Các cách hiệu quả để sử dụng Bảng trò chuyện AI bao gồm:

  • Yêu cầu giải thích: "Mã này làm gì?" hoặc "Giải thích cách hoạt động của hàm này"
  • Yêu cầu phát sinh mã: "Tạo một biểu mẫu đăng nhập với các trường email và mật khẩu"
  • Tìm kiếm sự trợ giúp gỡ lỗi: "Tại sao tôi nhận được lỗi này?" theo sau là thông báo lỗi
  • Học các khái niệm: "Giải thích khái niệm closure trong JavaScript" hoặc "Làm thế nào để tôi sử dụng async/await?"

Bảng trò chuyện duy trì ngữ cảnh trong suốt phiên của bạn, cho phép hỏi lại và phát triển lặp lại. Sự nhận thức ngữ cảnh này có nghĩa là bạn có thể tinh chỉnh yêu cầu của mình mà không cần lặp lại thông tin, làm cho quá trình phát triển trở nên tự nhiên và hiệu quả hơn.

Chỉnh sửa trực tuyến và Composer mã

Đằng sau bảng trò chuyện, Cursor cung cấp hai cách mạnh mẽ để tương tác trực tiếp với AI trong mã của bạn:

Chỉnh sửa trực tuyến (Ctrl+K/Cmd+K): Chọn một khối mã, nhấn phím tắt và mô tả những thay đổi bạn muốn. AI sẽ sửa đổi mã đã chọn theo chỉ dẫn của bạn. Tính năng này lý tưởng cho:

  • Refactoring mã hiện có
  • Thêm chức năng vào một phương thức
  • Sửa lỗi hoặc triển khai xử lý lỗi
  • Chuyển đổi mã giữa các kiểu hoặc mẫu khác nhau

Composer (Ctrl+I/Cmd+I): Tính năng nâng cao này giúp giải quyết các nhiệm vụ lớn bằng cách chia chúng thành các bước có thể xử lý. Composer cung cấp một phương pháp có cấu trúc cho các nhiệm vụ phát triển phức tạp, hướng dẫn bạn qua quy trình trong khi sinh ra mã cần thiết.

Tích hợp terminal và môi trường chạy

Terminal tích hợp, có thể truy cập qua View > Terminal hoặc Ctrl+` (dấu ngã), cho phép bạn thực hiện các lệnh mà không rời khỏi Cursor. Terminal này hoạt động giống như bất kỳ giao diện dòng lệnh nào, cho phép bạn:

  • Chạy mã của bạn
  • Cài đặt các phụ thuộc
  • Thực hiện các quá trình xây dựng
  • Quản lý kiểm soát phiên bản
  • Triển khai ứng dụng

Đối với người mới, terminal có thể có vẻ đáng sợ lúc đầu, nhưng nó trở thành một công cụ thiết yếu khi bạn tiến bộ. AI của Cursor cũng có thể giúp ở đây - bạn có thể yêu cầu lệnh terminal trong bảng trò chuyện, sau đó sao chép và dán vào cửa sổ terminal.

Bằng cách làm quen với các phần tử giao diện này, bạn tạo ra một nền tảng cho lập trình hiệu quả với Cursor. Sự kết hợp giữa chức năng của trình soạn thảo truyền thống và sự trợ giúp của AI tạo ra một môi trường phát triển độc đáo, nơi các rào cản kỹ thuật được giảm thiểu, cho phép bạn tập trung vào việc hiện thực hóa những ý tưởng của mình.

Thực hành tốt nhất: Nâng cao Cursor với Apidog MCP Server

Tích hợp Cursor với Apidog MCP Server đại diện cho một sự tiến bộ đáng kể cho các nhà phát triển làm việc với API. Sự kết hợp mạnh mẽ này kết nối khoảng cách giữa các thông số API và việc triển khai mã, cho phép phát triển hỗ trợ bởi AI chính xác hơn với tài liệu API của bạn. Phần này hướng dẫn bạn qua quy trình thiết lập và khám phá những lợi ích của sự tích hợp này.

Hiểu về Apidog MCP Server và các lợi ích của nó

Máy chủ Apidog Model Context Protocol (MCP) hoạt động như một kênh liên lạc giữa các thông số API của bạn và các trợ lý lập trình AI như Cursor. Bằng cách cung cấp cho Cursor quyền truy cập trực tiếp vào tài liệu API của bạn, MCP Server cho phép tạo mã chính xác hơn, tốt hơn trong việc gợi ý nhận thức ngữ cảnh và giảm thời gian tra cứu tài liệu.

Các lợi ích chính của sự tích hợp này bao gồm:

  • Nhận thức ngữ cảnh: Cursor hiểu các điểm cuối, tham số, cấu trúc phản hồi và yêu cầu xác thực của API của bạn
  • Tạo mã chính xác: Mã được tạo ra chính xác bằng tài liệu API của bạn, giảm thiểu lỗi tích hợp
  • Độ nhất quán của tài liệu: Việc triển khai vẫn đồng bộ với tài liệu khi API của bạn phát triển
  • Tăng cường năng suất: Loại bỏ việc phải chuyển đổi liên tục giữa tài liệu và trình soạn thảo mã
  • Gia tốc học tập: Giúp các thành viên mới trong nhóm nhanh chóng hiểu và làm việc với API của bạn

Sự tích hợp này đặc biệt đáng giá đối với các nhóm duy trì API phức tạp hoặc các nhà phát triển làm việc với các dịch vụ bên thứ ba cung cấp các thông số OpenAPI.

Thiết lập tích hợp Apidog MCP Server

Để kết nối Cursor với các thông số API của bạn qua máy chủ Apidog MCP, hãy làm theo các bước sau:

Các yêu cầu tiên quyết:

  • Đảm bảo Node.js (phiên bản 18 trở lên) được cài đặt trên hệ thống của bạn
  • Có một tài khoản Apidog với quyền truy cập vào dự án API của bạn
  • Cursor nên được cài đặt và chạy

Tạo mã truy cập Apidog:

  • Đăng nhập vào tài khoản Apidog của bạn
  • Đi đến Cài đặt tài khoản > Mã truy cập API
  • Tạo một mã mới và sao chép nó vào một vị trí an toàn
tạo mã truy cập API mới

Tìm ID dự án Apidog của bạn:

  • Mở dự án của bạn trong Apidog
  • Đi đến Cài đặt trong thanh bên trái
  • Tìm và sao chép ID dự án từ Cài đặt cơ bản
lấy ID dự án API

Cấu hình Cursor cho tích hợp MCP:

  • Tạo hoặc chỉnh sửa tệp cấu hình MCP ở một trong các vị trí này:
  • Cấu hình toàn cục: ~/.cursor/mcp.json
  • Cấu hình cụ thể cho dự án: .cursor/mcp.json trong thư mục dự án của bạn
  • Thêm cấu hình JSON sau:
{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--project=<project-id>"
      ],
      "env": {
        "APIDOG_ACCESS_TOKEN": "<access-token>"
      }
    }
  }
}
Thực hành tốt nhất khi sử dụng Cursor: Kết nối thông số API qua máy chủ Apidog MCP

Lưu cấu hình và khởi động lại Cursor để áp dụng thay đổi

Đối với người dùng Windows, nếu cấu hình tiêu chuẩn không hoạt động, hãy sử dụng định dạng đường dẫn thay thế này:

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--project=<project-id>",
        // Cần thiết cho triển khai tại chỗ:
        "--apidog-api-base-url=<Địa chỉ API của máy chủ tại chỗ, bắt đầu bằng http:// hoặc https://>"
      ],
      "env": {
        "APIDOG_ACCESS_TOKEN": "<access-token>"
      }
    }
  }
}

Làm việc với các thông số OpenAPI

Nếu bạn đang sử dụng các thông số OpenAPI/Swagger tiêu chuẩn thay vì các dự án Apidog, bạn có thể cấu hình MCP Server để đọc các tệp này trực tiếp:

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--oas=<oas-url-or-path>"
      ]
    }
  }
}

Sự linh hoạt này cho phép bạn làm việc với bất kỳ tài liệu API nào tuân theo tiêu chuẩn OpenAPI, không chỉ những tài liệu được tạo trong Apidog.

Để biết thêm chi tiết, hãy xem Tài liệu trợ giúp Apidog.

Tận dụng sự tích hợp trong quy trình làm việc của bạn

Khi việc tích hợp đã được thiết lập, bạn có thể bắt đầu sử dụng nó trong quy trình phát triển của mình. Dưới đây là một số cách hiệu quả để tận dụng kết nối này:

Tạo mã dựa trên tài liệu API:

Sử dụng MCP để lấy tài liệu API và tạo các giao diện TypeScript cho sơ đồ Người dùng

Tạo khách hàng API:

Tạo một hook React để tương tác với API quản lý sản phẩm dựa trên tài liệu API của chúng tôi

Cập nhật mã để phù hợp với các thay đổi của API:

Cập nhật lớp dịch vụ này để xử lý các tham số mới trong điểm cuối /users theo tài liệu API của chúng tôi

Thêm chi tiết tài liệu vào mã:

Thêm nhận xét cho mỗi trường trong lớp này dựa trên các ràng buộc được xác định trong tài liệu API của chúng tôi

Bằng cách làm theo các bước thiết lập và thực hành tích hợp này, bạn tạo ra một môi trường phát triển mạnh mẽ nơi mã và các thông số API của bạn giữ được sự hài hòa hoàn hảo. Cách tiếp cận này không chỉ tăng tốc độ phát triển mà còn cải thiện chất lượng mã và giảm thiểu các vấn đề tích hợp, làm cho nó trở thành một thiết lập thiết yếu cho phát triển API nghiêm túc với Cursor.

Kết luận: Biến đổi trải nghiệm phát triển của bạn với Cursor

Thiết lập Cursor không chỉ là cài đặt một trình soạn thảo mã - đó là một sự chuyển mình hướng tới phát triển phần mềm hỗ trợ AI. Bằng cách hòa quyện sự quen thuộc của lập trình truyền thống với các khả năng AI mạnh mẽ, Cursor đơn giản hóa cả quá trình học tập và triển khai. Thiết lập trực quan của nó tạo nền tảng cho việc điều hướng dễ dàng hơn, làm cho việc áp dụng các khái niệm lập trình mới trở nên dễ dàng hơn.

Được tích hợp với máy chủ Apidog MCP, Cursor đảm bảo tính đồng bộ liền mạch với API, giảm thiểu những khác biệt giữa tài liệu và mã. Dù bạn là người mới bắt đầu dựa vào AI để hướng dẫn hay là một nhà phát triển dày dạn sử dụng nó để tự động hóa các nhiệm vụ thường xuyên, Cursor sẽ thích nghi với nhu cầu của bạn. Chìa khóa để tối đa hóa tiềm năng của nó nằm ở sự giao tiếp rõ ràng - các gợi ý cụ thể dẫn đến phản hồi AI tốt hơn. Khi phát triển phần mềm phát triển, những công cụ như Cursor đang định nghĩa lại cách viết mã, làm cho quá trình này trở nên hiệu quả, trực quan và sáng tạo hơn.