Конфигурация PyCharm под задачи Python разработчика

      # Пример выбора системного Python 3.12 в Ubuntu
      # Путь: /usr/bin/python3.12
      # После настройки в списке пакетов отобразятся все установленные библиотеки.
    

      python -m venv my_project_venv
      source my_project_venv/bin/activate  # Linux/macOS
      my_project_venv\Scripts\activate   # Windows
    

      # Исходный код до Black
      def foo(   x):
          return x+1

      # После форматирования
      def foo(x):
          return x + 1
    

      # Пример конфигурационного файла .flake8 в корне проекта
      [flake8]
      max-line-length = 120
      ignore = E203, W503
      exclude = .git,__pycache__,venv
    

      # Пример файла с аннотациями
      def greet(name: str) -> str:
          return "Hello " + name

      # Mypy пройдёт без ошибок, если типы корректны
      # Если передать число: greet(123) -> mypy выдаст ошибку
    

      # Пример параметров для скрипта, принимающего аргументы
      # Script path: /home/user/project/main.py
      # Parameters: --port 8080 --debug
      # При запуске в main.py будет sys.argv = ['main.py', '--port', '8080', '--debug']
    

Расширенные примеры настройки PyCharm

Ниже приведены дополнительные сценарии настройки, которые выходят за рамки базовых вариантов и требуют более глубокого понимания инструментов.

Как настроить несколько виртуальных окружений для разных веток проекта?

В проектах с несколькими версиями зависимостей (например, при переключении между ветками git) полезно иметь отдельные окружения. В PyCharm можно быстро переключать интерпретаторы через выпадающий список в правом нижнем углу (рядом с иконкой Python). Однако для автоматизации удобно использовать .env файлы или скрипты настройки.

    # Скрипт для создания окружения для ветки dev
    #!/bin/bash
    ENV_DIR="./venv_dev"
    python3.10 -m venv $ENV_DIR
    source $ENV_DIR/bin/activate
    pip install -r requirements_dev.txt

    # Затем в PyCharm добавить этот интерпретатор как Existing environment
  

Пример интеграции с Git hooks: в файле .git/hooks/post-checkout можно автоматически пересоздавать окружение при смене ветки.

    # .git/hooks/post-checkout (упрощенный вариант)
    #!/bin/sh
    BRANCH=$(git rev-parse --abbrev-ref HEAD)
    if [ -f "requirements_$BRANCH.txt" ]; then
        python -m venv "./venv_$BRANCH"
        source "./venv_$BRANCH/bin/activate"
        pip install -r "requirements_$BRANCH.txt"
    fi
  

Как настроить удалённый интерпретатор (SSH) в PyCharm?

При работе с удалённым сервером или Docker-контейнером полезно использовать интерпретатор, расположенный на удалённой машине. Настройка: File -> Settings -> Project -> Python Interpreter -> Add -> SSH Interpreter. Указать хост, пользователя, путь к интерпретатору (например, /usr/bin/python3). После подключения PyCharm синхронизирует локальные файлы с сервером через SFTP.

    # Пример настройки SSH интерпретатора:
    # Host: 192.168.1.100
    # Port: 22
    # User: developer
    # Python interpreter path: /usr/bin/python3.11
    # После сохранения локальный код будет автоматически загружаться на сервер.
  

Как настроить Docker-интерпретатор для изолированной среды?

Использование Docker позволяет полностью воспроизвести окружение продакшена. Настройка: Add -> Docker Compose или Docker. В первом случае указать файл docker-compose.yml и имя сервиса. Во втором - образ Docker и команду (например, python3).

    # Пример docker-compose.yml
    version: '3'
    services:
      app:
        image: python:3.11-slim
        volumes:
          - .:/app
        working_dir: /app
        command: tail -f /dev/null  # чтобы контейнер не завершался
    # В PyCharm: добавить интерпретатор как Docker Compose -> app
  

Как интегрировать pre-commit хуки с PyCharm?

Pre-commit - инструмент для автоматической проверки кода перед коммитом. Установка: pip install pre-commit. Затем создать файл .pre-commit-config.yaml в корне проекта. PyCharm может запускать pre-commit через внешний инструмент или через терминал.

    # .pre-commit-config.yaml
    repos:
      - repo: https://github.com/psf/black
        rev: 24.1.0
        hooks:
          - id: black
      - repo: https://github.com/pycqa/flake8
        rev: 7.0.0
        hooks:
          - id: flake8
  

После настройки выполнить pre-commit install. В PyCharm при попытке сделать коммит (через VCS -> Commit) будут выполнены хуки. Результаты отобразятся в окне Version Control.

Как настроить автозамену импортов (isort) в PyCharm?

Isort сортирует импорты по стандартным правилам. Установка: pip install isort. В PyCharm можно добавить как внешний инструмент или использовать плагин isort. Для автоматического сортирования при сохранении настройте File Watcher аналогично Black, указав программу isort с аргументом $FilePath$.

    # Содержимое .isort.cfg
    [settings]
    profile = black
    line_length = 120
  

Пример до и после сортировки:

    # До isort
    import os
    import sys
    from typing import List
    import django

    # После isort
    import os
    import sys
    from typing import List

    import django
  

Как расширить функциональность PyCharm с помощью плагинов?

Плагины добавляют новые возможности. Установка: File -> Settings -> Plugins -> Marketplace. Полезные плагины для Python:

• Rainbow Brackets - раскраска скобок для улучшения читаемости.
• GitToolBox - дополнительная информация Git, автообновление статуса.
• Material Theme - кастомизация внешнего вида.
• Code With Me - совместное редактирование кода в реальном времени.

После установки плагины часто требуют перезапуска IDE. Конфликты плагинов встречаются редко, но если наблюдаются ошибки, стоит отключать плагины по одному.