Индикаторы сгенерированного кода (AI Code Smells)

1. Обзор концепции и системная проблема

Любой опытный Senior-инженер во время собеседования или аудита репозитория может за 5 секунд сказать: «Этот код написала человек, который понимает, что делает, а этот — просто слепо скопирован из чат-бота без какого-либо ревью».

Искусственный интеллект пишет быстро, но у него есть специфические манеры и «вредные привычки», которые в индустрии называют AI Code Smells.

Знать эти индикаторы необходимо каждому новичку: это поможет вам вовремя очищать проект от синтетического мусора и выглядеть профессиональным разработчиком в глазах коллег и заказчиков.

2. Главные индикаторы кода от нейросетей

┌─────────────────────────────────────────────────────────────┐
│                 ТОП-4 ИНДИКАТОРА «AI CODE SMELLS»          │
├─────────────────────────────────────────────────────────────┤
│ 1. 📢 Банальные комментарии-капитаны:                      │
│    // Присваиваем значение переменной a                     │
│    const a = 10; // Это число десять                       │
├─────────────────────────────────────────────────────────────┤
│ 2. 🖨️ Дублирование утилит в каждом файле:                 │
│    Вместо импорта общей функции `formatDate()` ИИ копирует  │
│    одинаковую функцию на 15 строк в 7 разных компонентах    │
├─────────────────────────────────────────────────────────────┤
│ 3. 🙈 Пустые блоки поглощения ошибок:                       │
│    try { doSomething(); } catch (e) { /* ничего не делаем */│
│    (Ошибка происходит, но вы никогда о ней не узнаете)     │
├─────────────────────────────────────────────────────────────┤
│ 4. 🤹 Гиперусложнение простых вещей:                       │
│    Создание 3 классов, фабрики и интерфейса ради одной      │
│    математической операции сложения двух чисел              │
└─────────────────────────────────────────────────────────────┘

3. Как преобразовать синтетический код в профессиональный

Сравните два фрагмента кода:

❌ До (Типичный сырой вывод ИИ):

// Функция, которая проверяет пользователя
function checkUser(user: any) {
  try {
    // Если пользователь существует
    if (user != null) {
      // Возвращаем истину
      return true;
    }
  } catch (err) {
    console.log("Ошибка");
  }
  return false;
}

✅ После (Очищенный инженерный код):

export function isUserActive(user: User | null): boolean {
  return Boolean(user?.isActive);
}

4. Чек-лист очистки проекта перед релизом

• Удалите все очевидные комментарии, которые повторяют то, что и так написано в названии переменной.
• Проверьте типы: замените все небрежные any на конкретные типы TypeScript.
• Вынесите повторяющиеся куски кода в отдельную папку src/lib или src/utils.
• Убедитесь, что все сообщения об ошибках действительно логируются, а не прячутся в пустых блоках catch.

5. Подводные камни, типовые ошибки и безопасность

• Подводные камни: Не игнорируйте индикаторы AI Code Smells, так как они могут привести к серьезным проблемам в будущем.
• Типовые ошибки: Часто разработчики не замечают дублирование кода, что ведет к усложнению поддержки.
• Безопасность: Убедитесь, что обработка ошибок реализована корректно, чтобы избежать утечек информации о системе.