Почему расширение VS Code Cpptools не показывает комментарии к документам функций для функций с перегрузками?
Кто-нибудь знает, как убрать перегрузки во всплывающем окне с быстрой информацией для vscode? Если я наведу курсор на функцию без перегрузок, она покажет описание комментария, которое я написал для функции с помощью /**. Но если я наведу курсор на функцию с перегрузками, они просто покажут сигнатуры функций для всех перегрузок.
Версия расширения C/C++: v1.15.4
Пример кода:
/**
@brief This is a function.
*/
void foo(int x) {}
/**
@brief This is a function.
*/
void foo(float x) {}
Скриншоты:
Ответы 2
Вкратце: это известная проблема, связанная с текущими ограничениями производительности. Подождите терпеливо, и исправление придет в будущем.
Если вы погуглите «site:github.com/microsoft/vscode-cpptools/issues overload comment hover», вы обнаружите (для меня это был лучший результат поиска) Комментарии к документам не отображаются для перегруженных методов #6008 , где сопровождающий (@sean-mcmanus) написал:
В настоящее время мы показываем комментарии к документам только для «активной подписи», но когда перегрузки различаются по типу, мы в конечном итоге выбираем неправильную перегрузку (например, # 2206).
Мы намеренно пропустили отправку дополнительных комментариев к перегруженным документам, поскольку потенциально это может занять слишком много времени. У нас была идея отправлять комментарии к документам, если они могли быть вычислены менее чем за 1 секунду, но мы беспокоились, что пользователи могут быть сбиты с толку противоречивыми результатами.
Мы ожидаем, что это будет исправлено после того, как мы исправим проблему производительности с комментариями к документам позже.
По-видимому, если ваш параметр C_Cpp.intelliSenseEngine установлен на Tag Parser, изменение его на default может дать вам желаемое поведение (источник).
Я смог решить эту проблему с помощью сопровождающего. Это произошло потому, что мой intelliSenseEngine был установлен на Tag Parser вместо default.
Спасибо. Я обновил свой ответный пост, чтобы также добавить эту информацию.
@starball github.com/microsoft/vscode-cpptools/issues/11071