Как исправить ошибку 'no encoding declared' в скриптах Python

Раздел: Python -> Ошибки и отладка

Ошибка 'no encoding declared' в Python: причины и исправление

Ошибка SyntaxError: Non-ASCII character ... but no encoding declared возникает, когда исходный код Python содержит символы, не входящие в ASCII, а в начале файла отсутствует объявление кодировки. Это характерно для Python 2, где по умолчанию используется ASCII, и для Python 3, если файл сохранён не в UTF-8. Без явного указания интерпретатор не может корректно прочитать файл.

Как наиболее эффективно устранить ошибку 'no encoding declared'?

Самое надёжное решение - добавить в первую или вторую строку файла специальный комментарий, указывающий кодировку. Чаще всего используется UTF-8.

#!/usr/bin/env python
# -* - coding: utf-8 -* -
print('Привет, мир!')

Python but no encoding declared (ошибка 'no encoding declared' в python)

Объявление кодировки должно соответствовать шаблону coding[:=]\s*([\w\-.]+). Допустимы варианты # coding: utf-8 или # encoding: cp1251. После добавления этой строки интерпретатор распознаёт символы вне ASCII и ошибка исчезает. Убедитесь, что файл физически сохранён в той же кодировке, которая указана в комментарии.

Какие ещё способы существуют для решения ошибки 'no encoding declared'?

Как использовать shebang с указанием кодировки для скриптов Unix?

В Unix-подобных системах можно объединить shebang и объявление кодировки в первой строке. Например:

#!/usr/bin/env python
# -* - coding: utf-8 -* -

Importerror python cannot import (ошибка импорта cannot import)

Этот подход удобен для исполняемых скриптов. При запуске через ./script.py система использует правильную кодировку.

Как избежать ошибки, используя только ASCII-символы в исходном коде?

Если в коде не требуется не-ASCII символов, можно обойтись без объявления кодировки. Однако это не решает проблему при работе с русским текстом. Цель - временное решение для чистых ASCII-проектов.

Как изменить кодировку файла в редакторе, не меняя исходного кода?

Некоторые редакторы (например, VS Code, PyCharm) позволяют пересохранить файл в UTF-8. После этого можно добавить объявление кодировки. Цель - синхронизация кодировки файла и указанной в коде.

Как решить проблему для Python 3 без явного объявления, если файл в UTF-8?

В Python 3 UTF-8 используется по умолчанию. Если файл сохранён в UTF-8 и не содержит BOM, объявление можно не добавлять. Но для файлов в других кодировках (например, cp1251) объявление строго обязательно.

Можно ли использовать sys.setdefaultencoding для обхода ошибки?

Технически возможно, но категорически не рекомендуется. Этот метод устарел и может привести к неожиданным ошибкам в библиотеках. Применяйте только для экспериментов, никогда не используйте в production.

import sys
reload(sys)
sys.setdefaultencoding('utf-8')

Типичные проблемы и ошибки при объявлении кодировки

  • Неправильный синтаксис объявления. Например, # encoding:utf-8 без пробела или с лишними символами. Шаблон: coding[:=]\s*([\w\-.]+). Не допускается использование кавычек.
  • Кодировка не соответствует реальному содержанию файла. Если файл физически сохранён в cp1251, а объявлена UTF-8, возникнет ошибка декодирования.
  • Проблемы с BOM (Byte Order Mark) в UTF-8. Некоторые редакторы (например, Notepad) добавляют BOM в начало файла. Python может не распознать объявление кодировки из-за BOM. Рекомендуется использовать UTF-8 без BOM.
  • Объявление кодировки не в первой или второй строке. Интерпретатор проверяет только первые две строки. Если объявление окажется дальше, оно будет проигнорировано.
  • Путаница между Python 2 и Python 3. В Python 2 ошибка возникает всегда при наличии не-ASCII символов. В Python 3 - только если кодировка файла не UTF-8. Используйте универсальный подход: всегда указывать кодировку в начале файла.

Практические примеры с кодом и результатами

Пример 1: Ошибка в Python 2 без объявления кодировки

Файл hello.py содержит русский комментарий:

Пример 
# Привет, мир
print('Hello')

Запуск: python hello.py

SyntaxError: Non-ASCII character '\xd0' in file hello.py on line 1, but no encoding declared; see http://python.org/dev/peps/pep-0263/ for details

Пример 2: Исправление с помощью объявления кодировки UTF-8

Добавляем строку кодировки:

Пример 
# -*- coding: utf-8 -*-
# Привет, мир
print('Hello')

Теперь код выполняется без ошибок.

Hello

Пример 3: Python 3 с файлом в кодировке cp1251

Создайте файл test_cp1251.py в кодировке cp1251 (например, в Windows). Содержимое:

Пример 
# -*- coding: cp1251 -*-
print('Привет, мир')

Если убрать объявление кодировки, Python 3 выдаст ошибку декодирования:

SyntaxError: (unicode error) 'utf-8' codec can't decode byte 0xcf in position 22: invalid continuation byte

Пример 4: Shebang и объявление кодировки в Unix-скрипте

Пример 
#!/usr/bin/env python
# -*- coding: utf-8 -*-
print('Скрипт работает')

После chmod +x script.py скрипт запускается напрямую. Ошибка не возникает.

Пример 5: Неправильное использование sys.setdefaultencoding (не рекомендуется)

Пример 
import sys
reload(sys)
sys.setdefaultencoding('utf-8')
print('Тестовый текст с кириллицей')

Запуск возможен, но модули могут вести себя нестабильно. В Python 3 такой код вызовет исключение AttributeError: module 'sys' has no attribute 'setdefaultencoding'.

Пример 6: Python 2 – работа с читаемыми строками из файла в другой кодировке

Пример 
# -*- coding: utf-8 -*-
import io
with io.open('data.txt', 'r', encoding='cp1251') as f:
    content = f.read()
print(content)

Если в data.txt содержится русский текст в CP1251, чтение будет корректным благодаря указанию кодировки при открытии файла. Объявление кодировки в исходном коде необходимо для правильной интерпретации строковых литералов внутри самого скрипта.

Ошибка 'no encoding declared' в Python - comments

En
Python but no encoding declared (python)