Python: Как записать переменную в файл – Полное руководство

Чтобы подставить значение строковой переменной в текстовый файл в Python, необходимо использовать форматирование строк, чтобы вставить значение переменной, а не её имя. В вашем текущем коде записывается буквальный текст «TotalAmount» вместо значения переменной. Правильный способ – использовать f‑строки или другие методы форматирования строк.

Содержание

• Базовое решение с использованием f‑строк
• Альтернативные методы форматирования строк
• Лучшие практики при работе с файлами
• Распространённые ошибки и устранение неполадок
• Полный рабочий пример

Базовое решение с использованием f‑строк

Самый современный и читаемый подход – использовать f‑строки. Согласно официальной документации Python, f‑строки позволяют вставлять выражения внутрь строковых литералов с помощью фигурных скобок {}.

Вот как исправить ваш код:

TotalAmount = 100.50  # Ваша переменная с реальным значением

# Используем форматирование f‑строки
text_file = open("Output.txt", "w")
text_file.write(f"Purchase Amount: {TotalAmount}")
text_file.close()

Ключевое отличие – префикс f перед строкой и фигурные скобки {TotalAmount} вокруг имени переменной. Это говорит Python заменить {TotalAmount} фактическим значением, хранящимся в переменной.

Альтернативные методы форматирования строк

Хотя f‑строки рекомендуются, есть и другие способы добиться того же результата:

Использование метода .format()

TotalAmount = 100.50
text_file = open("Output.txt", "w")
text_file.write("Purchase Amount: {}".format(TotalAmount))
text_file.close()

Использование старого стиля форматирования

TotalAmount = 100.50
text_file = open("Output.txt", "w")
text_file.write("Purchase Amount: %s" % TotalAmount)
text_file.close()

Использование функции str()

TotalAmount = 100.50
text_file = open("Output.txt", "w")
text_file.write("Purchase Amount: " + str(TotalAmount))
text_file.close()

Каждый метод даёт одинаковый результат, но f‑строки обычно предпочтительнее благодаря читаемости и производительности.

Лучшие практики при работе с файлами

Использование менеджеров контекста

Всегда используйте менеджеры контекста (with), как рекомендует Python. Это обеспечивает надёжное закрытие файла.

TotalAmount = 100.50

with open("Output.txt", "w") as text_file:
    text_file.write(f"Purchase Amount: {TotalAmount}")

Обработка разных типов данных

Если переменная содержит разные типы данных, f‑строки автоматически преобразуют их в строки:

TotalAmount = 100.50
TaxRate = 0.08
Discount = 5.00

with open("Output.txt", "w") as text_file:
    text_file.write(f"Purchase Amount: {TotalAmount}\n")
    text_file.write(f"Tax Rate: {TaxRate}%\n")
    text_file.write(f"Discount: ${Discount}\n")

Добавление переводов строк

Чтобы каждое значение появлялось на отдельной строке, добавьте символы перевода строки \n:

TotalAmount = 100.50
with open("Output.txt", "w") as text_file:
    text_file.write(f"Purchase Amount: {TotalAmount}\n")

Распространённые ошибки и устранение неполадок

Запись имени переменной вместо её значения

Ваш исходный код имел эту проблему:

# НЕПРАВИЛЬНО – записывается "TotalAmount" буквально
text_file.write("Purchase Amount: " 'TotalAmount')

Забывание префикса f

# НЕПРАВИЛЬНО – всё равно записывается "{TotalAmount}" буквально
text_file.write("Purchase Amount: {TotalAmount}")

Неявное преобразование типов

Если вы работаете с нестроковыми данными, f‑строки автоматически обрабатывают преобразование, но другие методы могут потребовать явного преобразования:

# Работает с f‑строками
total = 100.50
text_file.write(f"Total: {total}")

# Может потребовать преобразования с другими методами
text_file.write("Total: " + str(total))

Проблемы с режимом файла

Убедитесь, что используете правильный режим:

• "w" – запись (создаёт новый файл или перезаписывает существующий)
• "a" – добавление (добавляет к существующему файлу)
• "r" – чтение (только чтение)

Полный рабочий пример

Ниже приведён полный практический пример, демонстрирующий правильную запись в файл с подстановкой переменных:

# Пример данных
TotalAmount = 150.75
CustomerName = "John Doe"
OrderID = "ORD-12345"

# Запись отформатированных данных в файл с использованием f‑строк и менеджера контекста
with open("receipt.txt", "w") as receipt_file:
    receipt_file.write("=" * 40 + "\n")
    receipt_file.write(f"RECEIPT FOR ORDER: {OrderID}\n")
    receipt_file.write(f"Customer: {CustomerName}\n")
    receipt_file.write("-" * 40 + "\n")
    receipt_file.write(f"Total Amount: ${TotalAmount:.2f}\n")  # Формат до 2 знаков после запятой
    receipt_file.write("=" * 40 + "\n")

# Чтение и проверка содержимого файла
print("File created successfully!")
with open("receipt.txt", "r") as file:
    print(file.read())

Файл receipt.txt будет выглядеть так:

========================================
RECEIPT FOR ORDER: ORD-12345
Customer: John Doe
----------------------------------------
Total Amount: $150.75
========================================

Главный вывод: f‑строки предоставляют самый простой и читаемый способ подстановки значений переменных в строки при записи в файлы. Не забывайте использовать менеджеры контекста для надёжной работы с файлами и учитывайте варианты форматирования числовых значений.

Источники

1. Документация Python 3.14.0 – Ввод и вывод
2. Python f-String – Форматирование строк в Python с f‑строками
3. Python f-String Tutorial – Форматирование строк в Python с примерами кода
4. Как записать строку в файл в Python | Delft Stack
5. Python’s F-String for String Interpolation and Formatting – Real Python

Заключение

• Используйте f‑строки с префиксом f и фигурными скобками {} для подстановки значений переменных в строки при записи в файлы.
• Всегда применяйте менеджеры контекста (with open() as file:) для надёжного закрытия файлов.
• Учитывайте варианты форматирования числовых значений, например {TotalAmount:.2f} для двух знаков после запятой.
• Избегайте записи имён переменных буквально – убедитесь, что используете реальные значения.
• Проверяйте ваш код чтением файла обратно, чтобы убедиться, что содержимое соответствует ожиданиям.

Правильный способ записать переменную TotalAmount в файл: text_file.write(f"Purchase Amount: {TotalAmount}") – это заменит слово «TotalAmount» на фактическое значение.