Символ @ в Cursor

В Cursor@Символ @ — это мощный инструмент для быстрого доступа и ссылок на различную контекстную информацию, помогая пользователям более эффективно взаимодействовать с ИИ.

В любом сценарии взаимодействия с ИИ (например,⌘Kвведите его в палитре команд, окне чата или терминале)@, он вызовет контекстное меню, автоматически фильтруя и рекомендуя наиболее релевантные ресурсы в текущем проекте (такие как файлы, фрагменты кода, документы и т. д.).

  • Клавиатурные операции: используйте↑/↓Используйте стрелки для навигации, Enter для подтверждения выбора. Если выбранный элемент является категорией (например,@Files), список дополнительно отфильтрует конкретные ресурсы в этой категории.

  • Стратегия чтения файлов: для ссылок на файлы вы можетеCtrl/⌘ Mпереключаться между режимами «полное чтение» и «сводное чтение» (например, ссылка на весь текст или только на ключевые части).


Символ @

@Символ поддерживает следующие основные команды:

ОсобенностиОписаниеСценарий использования
@FilesСсылается на весь файл как контекст. Поддерживает предварительный просмотр пути к файлу и обработку по частям.Когда нужно сослаться на конкретное содержимое файла, например на файлы кода, документы и т. д.
@FoldersСсылается на всю папку как контекст.Используется, когда в качестве контекста нужно предоставить большое количество файлов, например каталог проекта.
@CodeСсылается на конкретный фрагмент кода как контекст.Когда нужно выполнить запрос или операцию с конкретными фрагментами кода.
@CodebaseПоиск важных файлов или блоков кода в кодовой базе и их сортировка по релевантности.Используется, когда нужно найти релевантный код или файлы во всей кодовой базе.
@GitСканирование коммитов Git, диффов или pull-запросов, чтобы помочь найти проблемы.Используется, когда нужно проанализировать информацию, связанную с Git, например историю коммитов, диффы кода и т. д.
@WebПоиск информации в интернете в качестве дополнительного контекста.Используется, когда нужно получить последнюю информацию из интернета или внешние ресурсы.
@DocsОбращение к предустановленной сторонней документации или пользовательской документации. Поддерживает добавление пользовательской документации.Когда нужно обратиться к внешним документам или пользовательской базе знаний.
@DefinitionsСсылаться на все ближайшие определения как на контекст.Когда нужно ссылаться на определения, такие как переменные и функции, в текущем коде.
@ChatДобавить текущее сообщение чата в качестве контекста.Когда нужно ссылаться на предыдущее содержимое беседы в чате.

Советы по продвинутому использованию

Комбинированные команды:Ввод@Files src/utils/helper.js @Codebase, вы можете ссылаться на указанный файл и связать глобальный контекст кодовой базы, чтобы генерировать высоко персонализированный код.

Динамическая интеграция ресурсов:Вставьте в@Для ссылок в начале (например, @https://api.example.com/docs), Cursor автоматически проанализирует содержимое и включит его в контекст.

Конфиденциальность и управление конфигурацией:Через.cursorignoreФайл (например, .gitignore) исключает конфиденциальные файлы или каталоги из индексации. Добавьте пользовательские ссылки на документацию в Settings > Features > Docs, чтобы улучшить@DocsОбласть покрытия.

Типичные примеры использования

1. Генерация кода

  • Инструкция: Сгенерировать функциональность входа пользователя@Files src/models/user.js @Docs https://jwt.io/introduction
  • Результат: Сгенерировать безопасную логику аутентификации на основе существующей модели пользователя и официальной документации JWT.

2. Устранение ошибок

  • Команда: Объяснить причину этой ошибки@Code 12-25строка@Git HEAD~1
  • Результат: Проанализировать возможные проблемы, объединив фрагмент кода и историю последних коммитов.

3. Межфайловый рефакторинг

  • Команда: Преобразовать классовые компоненты в функциональные компоненты@Folders src/components @Codebase
  • Результат: Пакетно преобразовать и обеспечить совместимость с глобальными стилями и управлением состоянием.
Другие расширения