Что такое Линтер?

Линтер в разработке

Линтер (от англ. lint) — это автоматический инструмент анализа кода, который проверяет исходный код на наличие потенциальных ошибок, стилистических проблем, нарушений стандартов и других проблем, без запуска кода. Название происходит от названия утилиты lint для языка C, которая удаляла "ворс" (lint) из кода.

Зачем нужен линтер?

1. Находит ошибки до выполнения — перед тем как запустить код
2. Обеспечивает консистентность — весь код в проекте написан одинаково
3. Улучшает качество — предотвращает плохие практики
4. Экономит время — не нужно вручную проверять каждый файл
5. Помогает в обучении — новые разработчики видят правильный стиль
6. Облегчает code review — рецензенты фокусируются на логике, а не на стиле

Типы проблем, которые находит линтер

# 1. Синтаксические ошибки
if x = 5:  # Ошибка: = вместо ==
    pass

# 2. Неиспользуемые переменные и импорты
import os  # Не используется — линтер предупредит
num = 5

# 3. Нарушение PEP 8 (стандарт Python)
def my_func( ):  # Лишний пробел в скобках
    pass

x=1  # Нет пробелов вокруг оператора

# 4. Опасные конструкции
list = []  # Переопределение встроенной функции

# 5. Сложность кода
def very_long_function_with_many_branches():  # Если слишком сложная
    if condition1:
        if condition2:
            if condition3:
                # ... много вложенности
                pass

Популярные линтеры для Python

1. Pylint — самый строгий и полнофункциональный

# Установка
# pip install pylint

# Использование
# pylint my_file.py

# Результат: скор от 0 до 10, подробный отчет
# *** Module my_file
# C0103: Module name "my_file" doesn't conform to snake_case
# W0611: Unused import sys

2. Flake8 — легкий и универсальный

# pip install flake8
# flake8 my_file.py

# Результат:
# my_file.py:1:1: E302 expected 2 blank lines, found 1
# my_file.py:5:1: F841 local variable 'x' is assigned but never used
# my_file.py:8:80: E501 line too long (120 > 79 characters)

3. Ruff — очень быстрый, написан на Rust

# pip install ruff
# ruff check .

# Намного быстрее других линтеров
# Современный выбор для новых проектов

4. Black — автоматический форматер

# pip install black
# black my_file.py

# Автоматически исправляет форматирование
# После: код отформатирован и красив

5. isort — сортировка импортов

# pip install isort
# isort my_file.py

# До:
import os
from django.core import mail
import sys
from myapp.models import User

# После:
import os
import sys

from django.core import mail

from myapp.models import User

Конфигурация линтера

# .pylintrc или pyproject.toml
[tool.pylint]
max-line-length = 120
disable = [
    "missing-docstring",  # Не требовать docstring везде
    "too-many-arguments",  # Не жаловаться на много аргументов
]

# .flake8
[flake8]
max-line-length = 120
extend-ignore = E203, W503
exclude = .git,__pycache__,migrations

# pyproject.toml (для Ruff)
[tool.ruff]
line-length = 120
target-version = "py310"

Pre-commit hooks — запуск перед коммитом

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/psf/black
    rev: 23.12.0
    hooks:
      - id: black
  
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.1.8
    hooks:
      - id: ruff
        args: [--fix]
      - id: ruff-format
  
  - repo: https://github.com/PyCQA/isort
    rev: 5.13.2
    hooks:
      - id: isort

# Установка
# pip install pre-commit
# pre-commit install

# Теперь перед каждым коммитом запустятся все линтеры
# Если ошибки — коммит не пройдет

Пример работы линтера

# bad_code.py (до)
import os,sys
import json

def my_func(arg1,arg2):
    x=1
    y = 2
    result = x+y  # Нет пробелов
    return result

my_list = [1,2,3,4,5]
my_dict = {'a':1,'b':2}

# pylint bad_code.py
# Результаты:
# C0301: Line too long (50/79)
# C0111: Missing function docstring
# C0103: Variable name "x" doesn't conform

# bad_code.py (после автоисправления с black)
import json
import os
import sys

def my_func(arg1, arg2):
    """My function."""
    x = 1
    y = 2
    result = x + y
    return result

my_list = [1, 2, 3, 4, 5]
my_dict = {"a": 1, "b": 2}

CI/CD интеграция

# .github/workflows/lint.yml
name: Lint

on: [push, pull_request]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - uses: actions/setup-python@v4
        with:
          python-version: '3.11'
      
      - run: pip install ruff black isort
      
      - run: ruff check .
      - run: black --check .
      - run: isort --check-only .

# Теперь при каждом пуше/PR запускается линтер
# Если ошибки — PR не merge'нется

Выбор линтера

Для новых проектов рекомендую:

1. Ruff (проверка) + Black (форматирование)

   • Очень быстро
   • Простая конфигурация
   • Современный стек

2. Или Pylint если нужна максимальная строгость

3. isort для импортов (работает со всеми)

4. mypy для типизации (отдельный инструмент)

Линтер в IDE

# VS Code с Pylance/Python extension
# PyCharm — встроенные линтеры
# Vim/Neovim — через LSP (Language Server Protocol)

# Результат: подсветка ошибок прямо в редакторе
# При сохранении автоисправления (если настроено)

Типичная ошибка: игнорирование линтера

# ❌ Плохо
import subprocess  # noqa
x=1  # pylint: disable=line-too-long

# ✅ Хорошо
# Используй игнорирование только когда это действительно нужно
# И добавляй комментарий почему

import subprocess  # noqa: F401 — используется в eval()

# Или исправь реальную проблему:
x = 1  # Правильно отформатировано

Вывод

Линтер — это обязательный инструмент в профессиональной разработке. Он:

• Автоматически проверяет код на ошибки и стиль
• Экономит часы на code review
• Обеспечивает консистентность в проекте
• Помогает команде писать лучший код
• Интегрируется в CI/CD pipelines
• Экономит время и деньги

Безлинтерный код выглядит как текст без редактора — работает, но выглядит плохо и содержит ошибки.