[cursor docs] @ Definitions

개요

Cursor의 @ Definitions 기능은 코드베이스 내의 정의(함수, 클래스, 타입 등)를 빠르게 탐색하고, AI가 해당 정의의 맥락을 정확히 이해할 수 있도록 도와줍니다. 이 글에서는 @ Definitions의 개념, 주요 기능, 실제 사용 방법, 그리고 실무에서의 활용 팁을 단계별로 설명합니다.

@ Definitions란?

@ Definitions는 코드 내에서 함수, 클래스, 타입 등 다양한 정의를 빠르게 찾거나, AI가 특정 정의의 내용을 우선적으로 참고하도록 지정할 수 있는 기능입니다. 대규모 프로젝트에서도 원하는 정의를 신속하게 확인할 수 있습니다.

주요 기능

• 빠른 정의 탐색: @ 뒤에 정의명을 입력하면 프로젝트 내 모든 정의를 검색할 수 있습니다.
• 정의 기반 컨텍스트 제공: AI가 특정 함수, 클래스, 타입 등의 정의 내용을 우선적으로 참조합니다.
• 자동 완성 및 추천: 일부만 입력해도 자동 완성 기능이 동작합니다.
• 대규모 프로젝트 지원: 수많은 정의가 있는 환경에서도 빠른 탐색이 가능합니다.

실제 사용 방법

1. 정의 검색: 에디터에서 @를 입력한 뒤, 함수명, 클래스명, 타입명 등을 입력하면 해당 정의로 바로 이동할 수 있습니다.
2. AI 컨텍스트 강화: 프롬프트나 명령어에서 @정의명을 사용하면, AI가 해당 정의의 내용을 우선적으로 참고합니다.
3. 자동 완성 활용: 전체를 입력하지 않아도, 일부만 입력하면 자동 완성 리스트가 나타나 빠르게 선택할 수 있습니다.

실무 활용 팁

• 대규모 프로젝트에서는 정의 검색 기능을 적극 활용해, 원하는 정의로 빠르게 이동하세요.
• AI에게 특정 정의의 맥락을 명확히 전달하고 싶을 때 @정의명을 프롬프트에 포함시키면 더욱 정확한 답변을 받을 수 있습니다.
• 비슷한 이름의 정의가 많을 때는 자동 완성 리스트에서 원하는 항목을 쉽게 선택할 수 있습니다.

참고 자료

• Cursor 공식 문서: @ Definitions