Символ @ в 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
- Результат: Пакетно преобразовать и обеспечить совместимость с глобальными стилями и управлением состоянием.