Символы подчеркивания экранируются обратными косыми чертами в строках документов при написании Python в коде Visual Studio

#python #visual-studio-code

#python #visual-studio-code

Вопрос:

Когда я пытаюсь документировать свой код и указывать переменные, содержащие символы подчеркивания, они отображаются неправильно. Пример кода:

 def printl(tex_t):
"""
    Clears the console and prints whatever text is inputed, under a heading.

    Parameters
    ----------
        tex_t (String) : The text you want to print.

    Returns
    -------
        Nothing
"""
# Code goes here

  

Но я понимаю это:
введите описание изображения здесь

Я использую 64-разрядный Python 3.8.6 и расширение Python VSCode v2020.9.114305

РЕДАКТИРОВАТЬ: итак, я возился с Python.настройки languageserver, и похоже, что только Microsoft и Pylence имеют эту проблему. Переключение этого параметра на Jedi устраняет проблему.

Комментарии:

1. Похоже на очень специфическую ошибку. Попробуйте открыть проблему на github

2. Я использую Pylance и получаю это только во всплывающей подсказке для поставщика завершения (текст после также красный, и у меня есть a -> None в заголовке. Но всплывающая подсказка arguments при вводе ( является правильной.

3. строки документа интерпретируются как Markdown, удалите ----- строки, и вы получите другое поведение. В Markdown _ сигналы курсивом, но мы хотим, чтобы литерал _ экранировался, но средство визуализации всплывающей подсказки не понимает экранирование символов. Но переводчик Markdown не должен экранировать _