Русский язык в Python: практическое руководство по настройке окружения

Развёрнутые примеры команд и кода с результатами

Пример 1: Скрипт для проверки системной кодировки и настройки UTF‑8

# check_encoding.py
import sys, locale

print('System default encoding:', sys.getdefaultencoding())
print('Filesystem encoding:', sys.getfilesystemencoding())
print('Locale preferred encoding:', locale.getpreferredencoding())
print('Stdout encoding:', sys.stdout.encoding)

# Принудительная установка UTF-8 для stdout
if sys.stdout.encoding != 'utf-8':
    import io
    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
    print('Stdout encoding after fix:', sys.stdout.encoding)

# Проверка вывода русского текста
print('Тестовый вывод: Привет, мир!')

System default encoding: utf-8
Filesystem encoding: utf-8
Locale preferred encoding: UTF-8
Stdout encoding: utf-8
Тестовый вывод: Привет, мир!

Пример 2: Чтение и запись файла с русского текстом, явное указание кодировки

# file_rw.py

# Запись в файл (создание)
with open('russian.txt', 'w', encoding='utf-8') as f:
    f.write('Строка с кириллицей\nВторая строка')

# Чтение из файла
with open('russian.txt', 'r', encoding='utf-8') as f:
    content = f.read()
    print('Содержимое файла:')
    print(content)

# Дозапись в конец файла
with open('russian.txt', 'a', encoding='utf-8') as f:
    f.write('\nДобавленная строка')

# Повторное чтение
with open('russian.txt', 'r', encoding='utf-8') as f:
    print('После добавления:')
    print(f.read())

Содержимое файла:
Строка с кириллицей
Вторая строка
После добавления:
Строка с кириллицей
Вторая строка
Добавленная строка

Пример 3: Использование locale для сортировки и форматирования чисел

# locale_example.py
import locale

# Попытка установить русскую локаль (на Linux/macOS)
try:
    locale.setlocale(locale.LC_ALL, 'ru_RU.UTF-8')
    print('Локаль установлена: ru_RU.UTF-8')
except locale.Error:
    print('Локаль ru_RU.UTF-8 не найдена, пробуем Russian_Russia.1251...')
    try:
        locale.setlocale(locale.LC_ALL, 'Russian_Russia.1251')
        print('Локаль установлена: Russian_Russia.1251')
    except locale.Error:
        print('Не удалось установить русскую локаль. Доступные:', locale.locale_alias.keys())
        exit()

# Сортировка строк с учётом локали
words = ['ёлка', 'ель', 'Ёж', 'егерь', 'яблоко']
words_sorted = sorted(words, key=locale.strxfrm)
print('Отсортировано с locale:', words_sorted)

# Форматирование числа
formatted = locale.format_string('%d', 1234567, grouping=True)
print('Формат числа:', formatted)  # Для ru_RU вывод: 1 234 567

Локаль установлена: ru_RU.UTF-8
Отсортировано с locale: ['егерь', 'ель', 'ёлка', 'Ёж', 'яблоко']
Формат числа: 1 234 567

Пример 4: Работа с русским текстом в SQLite (BLOB vs TEXT)

# sqlite_rus.py
import sqlite3

conn = sqlite3.connect(':memory:')
cursor = conn.cursor()

# Создание таблицы с явным указанием кодировки (SQLite по умолчанию UTF-8)
cursor.execute('CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)')

# Вставка русских данных
cursor.execute('INSERT INTO users (name) VALUES (?)', ('Иван',))
cursor.execute('INSERT INTO users (name) VALUES (?)', ('Мария',))

# Запрос
cursor.execute('SELECT * FROM users')
rows = cursor.fetchall()
print('Пользователи:')
for row in rows:
    print(row[1])

conn.close()

Пользователи:
Иван
Мария

Пример 5: Установка переменной PYTHONUTF8 в Windows через реестр (постоянно)

# Установить PYTHONUTF8=1 для текущего пользователя (PowerShell от администратора)
[System.Environment]::SetEnvironmentVariable('PYTHONUTF8','1','User')

# Или cmd:
setx PYTHONUTF8 1

# Проверка после перезапуска консоли:
python -c "import sys; print(sys.flags.utf8_mode)"  # Должно быть 1

Без перезапуска можно применить в текущей сессии:

set PYTHONUTF8=1