Visual Studio Code для Python разработки

Расширенные примеры настройки и использования VS Code для Python

Настройка отладчика для Django и Flask

Для отладки веб-приложений требуются дополнительные конфигурации в launch.json.

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Django",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/manage.py",
            "args": ["runserver", "0.0.0.0:8000"],
            "django": true
        },
        {
            "name": "Flask",
            "type": "python",
            "request": "launch",
            "module": "flask",
            "env": {
                "FLASK_APP": "app.py",
                "FLASK_ENV": "development"
            },
            "args": ["run", "--no-debugger"],
            "jinja": true
        }
    ]
}

Результат: при запуске отладки (F5) с выбранной конфигурацией запускается сервер разработки с точками остановки.

Интеграция с pytest и запуск тестов

Настройка тестирования через pytest позволяет запускать тесты из редактора и видеть результаты.

// settings.json
{
    "python.testing.pytestEnabled": true,
    "python.testing.unittestEnabled": false,
    "python.testing.cwd": "${workspaceFolder}",
    "python.testing.pytestArgs": ["tests"]
}

После настройки в панели Testing (колба) появляются доступные тесты. Можно запускать отдельные тесты или все сразу.

# tests/test_sample.py
def test_addition():
    assert 1 + 1 == 2

def test_subtraction():
    assert 2 - 1 == 1

(venv) $ pytest
===================== test session starts =====================
collected 2 items

tests/test_sample.py ..                                  [100%]

===================== 2 passed in 0.02s =====================

Автоматическое форматирование при сохранении с Black

Настройка форматтера Black и форматирования при сохранении.

// settings.json
{
    "python.formatting.provider": "black",
    "editor.formatOnSave": true,
    "[python]": {
        "editor.defaultFormatter": "ms-python.python"
    }
}

Пример исходного кода и после форматирования:

# До сохранения:
def add( a,b ):
    return a + b

# После сохранения (автоматическое форматирование Black):
def add(a, b):
    return a + b

Мульти-рутовые проекты и поддержка нескольких папок

VS Code поддерживает workspace с несколькими корневыми папками. Это полезно для микросервисов или монолитных проектов.

// myproject.code-workspace
{
    "folders": [
        { "path": "backend" },
        { "path": "frontend" }
    ],
    "settings": {
        "python.defaultInterpreterPath": "${workspaceFolder:backend}/.venv/bin/python"
    }
}

При открытии файла из каждой папки будет использоваться свой интерпретатор (если настроено в workspace settings).

Глобальные сниппеты для Python

Создание собственных сниппетов ускоряет написание повторяющегося кода.

// File: %APPDATA%\Code\User\snippets\python.json (Windows)
// или ~/.config/Code/User/snippets/python.json (Linux/macOS)
{
    "Quick function": {
        "prefix": "defc",
        "body": [
            "def ${1:function_name}(${2:params}):",
            "    \"""${3:Docstring}\"""",
            "    ${4:pass}"
        ],
        "description": "Create a new Python function with docstring"
    },
    "If main guard": {
        "prefix": "ifmain",
        "body": [
            "if __name__ == \"__main__\":",
            "    ${1:main()}"
        ],
        "description": "Insert if __name__ == '__main__'"
    }
}

Использование: набрать defc и нажать Tab – сниппет подставит шаблон.

Настройка tasks.json для автоматических команд

Задачи позволяют запускать внешние команды (линтер, тесты, сборку) прямо из VS Code.

// .vscode/tasks.json
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run linter (pylint)",
            "type": "shell",
            "command": "pylint ${workspaceFolder}",
            "problemMatcher": ["$pylint"]
        },
        {
            "label": "Run tests with coverage",
            "type": "shell",
            "command": "pytest --cov=src tests/",
            "group": {
                "kind": "test",
                "isDefault": true
            }
        }
    ]
}

Запуск задачи: Ctrl+Shift+P → Tasks: Run Task → выбрать нужную. Результат отображается в панели терминала.

Настройка Git-интеграции

VS Code включает встроенную поддержку Git. Для Python полезно добавить автоматическое игнорирование виртуального окружения и кэша.

# .gitignore
.venv/
__pycache__/
*.pyc
.vscode/

Также можно настроить Git Lint для предкоммитной проверки (через tasks.json) с использованием pre-commit хуков.

Отладка с аргументами командной строки

Пример launch.json с передачей аргументов и перенаправлением вывода.

{
    "name": "Python: script with args",
    "type": "python",
    "request": "launch",
    "program": "${workspaceFolder}/cli.py",
    "args": ["--input", "data.txt", "--output", "result.csv"],
    "console": "externalTerminal",
    "cwd": "${workspaceFolder}"
}

При запуске отладчика откроется внешний терминал с переданными аргументами.

Удалённая разработка с интерпретатором на WSL

Если используется Windows Subsystem for Linux (WSL), установите расширение Remote - WSL. VS Code подключится к WSL и будет использовать интерпретатор и файловую систему Linux.

# Открыть папку в WSL из VS Code:
# Ctrl+Shift+P → Remote-WSL: Open Folder in WSL...
# Или в терминале WSL: code .

Все расширения (включая Python) устанавливаются на стороне WSL. Можно использовать виртуальное окружение внутри WSL и все инструменты Linux.