Reflower комментариев для Visual Studio - PullRequest
11 голосов
/ 03 декабря 2009

Есть ли встроенная команда или инструмент, который может перекомпоновывать комментарии C # в Visual Studio?

Иногда часть кода требует нескольких строк комментариев, и после обширного редактирования вам необходимо вручную вставить разрывы строк в соответствующих местах, чтобы они не проходили за правый край окна редактора. Я хотел бы иметь возможность сделать это с помощью одной клавиши.

После многих лет использования Visual Studio я все еще скучаю по способности M-q (c-fill-абзац) в emacs.

Редактировать: плагин Agent Smith не переформатирует комментарии в теле метода.

Ответы [ 4 ]

16 голосов
/ 12 июля 2010

Когда я был разработчиком Visual C ++, я написал довольно настраиваемый инструмент форматирования комментариев под названием Comment Reflower. С тех пор я поменял платформы и поэтому перестал делать порты, но, к счастью, Кристоф Нар сохранил его на уровне http://www.kynosarges.de/CommentReflower.html

12 голосов
/ 26 октября 2012

Если вы хотите получить почти идеальное выравнивание комментариев одним нажатием клавиши, используйте Reflower Comment .

Работает с VS2012, VS2013 и VS2015.

VS2012: установка / обновление. Reflower для Visual Studio 2012

Обновление 2015-08-31: теперь в галерее расширений доступно расширение Comment Reflower, которое легко устанавливается непосредственно из Tools > Extensions and Updates в VS2012, VS2013 и VS2015 .

  1. Загрузите «Comment Reflower» из http://www.kynosarges.de/CommentReflower.html,, распакуйте в каталог C:\Program Files (x86)\Visual Studio Comment Reflower.

  2. Обновить файл CommentReflower.Addin, чтобы Version увеличивался с 10.0 до 11.0 (это обновляет его с VS2010 до VS2012). ПРИМЕЧАНИЕ. В этом XML-файле есть два места, в которые необходимо обновить эту версию.

  3. В VS2012 выберите Tools..Options..AddIn Security и добавьте путь C:\Program Files (x86)\Visual Studio Comment Reflower.

  4. Перезапустить VS2012.

  5. Теперь появились новые пункты меню: Tools..Reflow Comment at Cursor и Tools..Comment Reflower Settings.

VS2013: установка / обновление. Reflower для Visual Studio 2013

Обновление 2015-08-31: Теперь в галерее расширений доступно расширение Comment Reflower, которое легко устанавливается непосредственно из Tools > Extensions and Updates в VS2012, VS2013 и VS2015 .

Повторите приведенные выше инструкции и измените версию на шаге 2 с 11.0 на 12.0.

VS2015: установка / обновление. Reflower для Visual Studio 2015

Теперь в галерее расширений доступно расширение Comment Reflower, которое легко устанавливается непосредственно из Tools > Extensions and Updates в VS2012, VS2013 и VS2015.

Спасибо @Martin Liversage за указание на это.

Чтобы добавить комбинацию клавиш, которая оправдывает текущий комментарий, ваш курсор на

  1. Перейдите к Tools..Options..Keyboard, введите reflow in Show commands containing, выберите CommentReflower.Connect.ReflowPoint, введите комбинацию клавиш (например, Ctrl-J) в поле Press shortcut keys, затем нажмите Assign.

  2. Теперь, если вы поместите курсор на комментарий и нажмете указанную комбинацию клавиш (Ctrl-J), он автоматически (и красиво) оправдает ваш комментарий. Вы должны увидеть связанный ключ в меню Tools:

enter image description here

Обновить ширину поля

Перейдите в Tools..Comment Reflower Settings и измените Wrap Width со значения по умолчанию 80 на что-то более широкое, например 140, а "Минимальная ширина блока" на 10 (для *not* установите его на меньшее !):

enter image description here

4 голосов
/ 03 декабря 2009

Если вы используете ReSharper, есть бесплатный плагин Agent Smith , который может переформатировать комментарии.

2 голосов
/ 17 мая 2015

Если вы используете // или /// стиль комментариев CodeMaid отлично сработал для меня. Это бесплатный и открытый исходный код, и я могу использовать его как на C ++, так и на C #.

...