Контекстные команды в Cursor: подробное руководство по @Code

Андрей Отинов -

Введение в контекстную команду @Code

Команда @Code в Cursor — это мощный инструмент, который позволяет ссылаться на конкретные фрагменты кода в вашем проекте при взаимодействии с искусственным интеллектом. В отличие от команд @Files и @Folders, которые добавляют в контекст целые файлы или папки, @Code позволяет точно указать нужные фрагменты кода, делая взаимодействие с AI более целенаправленным и эффективным.

@Code: обзор возможностей

Команда @Code предоставляет следующие ключевые возможности:

  1. Контекстный анализ кода — добавление выбранных фрагментов кода для более точного анализа
  2. Предварительный просмотр — отображение предварительного просмотра кода перед добавлением в контекст
  3. Символьный поиск — быстрая навигация по символам и функциям в кодовой базе
  4. Интеграция с редактором — специальные сочетания клавиш для добавления выделенного кода

Как использовать @Code в Cursor

Существует несколько способов использования команды @Code для добавления фрагментов кода в контекст:

1. Через символ @:

  1. Откройте окно чата (Ctrl/⌘ L), композитора (⌘I) или используйте Cmd K
  2. Введите символ @ и начните вводить слово "Code" или имя символа/функции
  3. Выберите нужный фрагмент кода из списка предложений
  4. Курсор покажет предварительный просмотр содержимого, чтобы вы могли убедиться, что выбрали нужный код

2. Через выделение кода в редакторе:

  1. Выделите код, который хотите добавить в контекст
  2. Используйте одну из следующих комбинаций клавиш:
  • Ctrl/⌘ Shift L — добавить выделенный код в окно чата
  • Ctrl/⌘ Shift K — добавить выделенный код в активное окно Cmd K
  • Ctrl/⌘ L — добавить выделенный код в новый чат

Практические примеры использования @Code

Анализ конкретной функции:

@Code getUserData Проанализируй эту функцию и предложи способы оптимизации производительности.

Объяснение алгоритма:

@Code sortAlgorithm Объясни, как работает этот алгоритм сортировки и какова его временная сложность.

Поиск ошибок в коде:

@Code validateInput Проверь эту функцию на наличие потенциальных ошибок и уязвимостей безопасности.

Интеграция с другими функциями Cursor

Команда @Code хорошо интегрируется с другими функциями Cursor:

  • Cmd K — быстрое редактирование выбранного кода с помощью AI
  • Composer — добавление нескольких фрагментов кода в один запрос для комплексных задач
  • Agent — использование кодовых фрагментов для направления работы агента

Продвинутые техники использования @Code

Комбинирование с другими контекстными командами:

@Code AuthController.login @Files models/User.js Как эта функция аутентификации взаимодействует с моделью пользователя? Есть ли потенциальные проблемы с безопасностью?

Использование с символами (определениями):

Вы можете ссылаться на конкретные символы или определения

@Code fetchData @Definitions fetchData Объясни, как реализована эта функция и где она используется в проекте

Анализ взаимодействий между компонентами:

@Code UserComponent.render @Code UserService.getProfile Объясни, как эти два компонента взаимодействуют друг с другом

Советы по эффективному использованию @Code

  1. Выбирайте минимально необходимый фрагмент кода — чем меньше и конкретнее фрагмент, тем точнее будет ответ AI
  2. Используйте для конкретных вопросов — команда @Code наиболее эффективна для анализа отдельных функций или блоков
  3. Комбинируйте с @Files для контекста — если функция взаимодействует с другими частями кода, добавьте необходимые файлы
  4. Используйте сочетания клавиш — это значительно ускоряет рабочий процесс

Заключение

Контекстная команда @Code в Cursor — это мощный инструмент для точного взаимодействия с AI при работе с конкретными фрагментами кода. Она позволяет проводить детальный анализ функций, классов и методов, не перегружая контекст лишней информацией из всего файла или проекта.Эффективно комбинируя @Code с другими контекстными командами, вы можете значительно повысить продуктивность работы и качество получаемых от AI результатов, делая Cursor по-настоящему умным помощником в вашей разработке.

[Источник: docs.cursor.com]