> **Источник:** https://python-all.ru/3.0/library/copy.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# `copy` – Операции поверхностного и глубокого копирования

Этот модуль предоставляет универсальные операции (поверхностного и глубокого) копирования.

Краткое описание интерфейса:

```python
import copy

x = copy.copy(y)        # создать поверхностную копию y
x = copy.deepcopy(y)    # создать глубокую копию y
```

Для ошибок, специфичных для модуля, возбуждается `copy.error`.

Разница между поверхностным и глубоким копированием актуальна только для составных объектов (объектов, содержащих другие объекты, например, списки или экземпляры классов):

- *Поверхностная копия* создаёт новый составной объект, а затем (насколько это возможно) вставляет в него *ссылки* на объекты, найденные в оригинале.
- *Глубокая копия* создаёт новый составной объект, а затем рекурсивно вставляет в него *копии* объектов из оригинала.

Две проблемы, часто возникающие при глубоком копировании, которых нет при поверхностном:

- Рекурсивные объекты (составные объекты, прямо или косвенно содержащие ссылку на себя) могут вызвать рекурсивный цикл.
- Поскольку глубокое копирование копирует *всё*, оно может скопировать слишком много, например, административные структуры данных, которые должны быть общими даже между копиями.

Функция `deepcopy()` позволяет избежать этих проблем следующим образом:

- хранение словаря “memo”, содержащего объекты, уже скопированные в текущем проходе копирования; и
- предоставления пользовательским классам возможности переопределить операцию копирования или набор копируемых компонентов.

Этот модуль не копирует такие типы, как модуль, метод, трассировка стека, кадр стека, файл, сокет, окно, массив и любые подобные типы. Он «копирует» функции и классы (поверхностно и глубоко), возвращая исходный объект без изменений; это совместимо с тем, как эти типы обрабатываются модулем [`pickle`](https://python-all.ru/3.0/library/pickle.html#module-pickle).

Поверхностные копии словарей можно создать с помощью [`dict.copy()`](https://python-all.ru/3.0/library/stdtypes.html#dict.copy), а копии списков – присваиванием среза всего списка, например, `copied_list = original_list[:]`.

Классы могут использовать те же интерфейсы для управления копированием, которые они используют для управления pickling. См. описание модуля [`pickle`](https://python-all.ru/3.0/library/pickle.html#module-pickle) для получения информации об этих методах. Модуль `copy` не использует [`copyreg`](https://python-all.ru/3.0/library/copyreg.html#module-copyreg) регистрационный модуль.

Чтобы класс мог определить собственную реализацию копирования, он может определить специальные методы `__copy__()` и `__deepcopy__()`. Первый вызывается для реализации операции поверхностного копирования; дополнительные аргументы не передаются. Второй вызывается для реализации операции глубокого копирования; ему передаётся один аргумент – словарь memo. Если реализация `__deepcopy__()` требует создать глубокую копию компонента, следует вызвать функцию `deepcopy()`, передав компонент первым аргументом, а словарь memo – вторым.

> **См. также**
>
> **Модуль [`pickle`](https://python-all.ru/3.0/library/pickle.html#module-pickle)**
>
> Обсуждение специальных методов, используемых для поддержки извлечения и восстановления состояния объекта.