번역 자료 / / 2025. 5. 20. 07:27

[cursor docs] @ Symbols Overview

개요

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

@ Symbols란?

@ Symbols는 코드 내에서 함수, 클래스, 변수 등 주요 심볼을 식별하고, 이를 기반으로 AI가 더 정확한 코드 분석과 추천을 할 수 있도록 지원하는 기능입니다. 대규모 코드베이스에서도 원하는 심볼을 빠르게 찾고, 관련 정보를 효율적으로 확인할 수 있습니다.

주요 기능

  • 빠른 심볼 탐색: @를 입력하면 프로젝트 내 모든 심볼을 검색할 수 있습니다.
  • 심볼 기반 컨텍스트 제공: AI가 특정 심볼의 정의, 사용처, 관련 코드를 자동으로 참조합니다.
  • 자동 완성 및 추천: 심볼 이름 일부만 입력해도 자동 완성 기능이 동작합니다.
  • 대규모 프로젝트 지원: 수많은 파일과 심볼이 있는 환경에서도 빠른 탐색이 가능합니다.

실제 사용 방법

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

실무 활용 팁

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

참고 자료

반응형
  • 네이버 블로그 공유
  • 네이버 밴드 공유
  • 페이스북 공유
  • 카카오스토리 공유