Преобразовать CSV в XLSX
Создаёт книгу Excel из CSV, настраивает ширину колонок и закрепляет шапку.
Что делает скрипт
Скрипт читает CSV с автоопределением разделителя или явным --delimiter, создаёт лист openpyxl и переносит строки. При включённом --detect-types целые, дробные числа и даты сохраняются как числа и даты. Ширина колонок подбирается по содержимому.
Быстрый старт
python csv_to_xlsx.py table.csv
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python csv_to_xlsx.py report.csv -o report.xlsx --detect-typespython csv_to_xlsx.py data.csv --delimiter ";" --sheet Data
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install openpyxl
python3 -m pip install openpyxl
python3 -m pip install openpyxl
csv_to_xlsx.py
#!/usr/bin/env python3
"""Преобразование CSV в книгу XLSX."""
from __future__ import annotations
import argparse
import csv
import io
import re
import sys
from datetime import date
from pathlib import Path
from openpyxl import Workbook
from openpyxl.utils import get_column_letter
def convert(value: str) -> object:
text = value.strip()
if not text:
return None
if re.fullmatch(r"-?\d+", text):
return int(text)
if re.fullmatch(r"-?\d+[.,]\d+", text):
return float(text.replace(",", "."))
if re.fullmatch(r"\d{4}-\d{2}-\d{2}", text):
try:
return date.fromisoformat(text)
except ValueError:
return value
return value
def main() -> int:
parser = argparse.ArgumentParser(description="Преобразовать CSV в XLSX")
parser.add_argument("input", type=Path, help="Исходный CSV")
parser.add_argument("-o", "--output", type=Path, help="Итоговый XLSX")
parser.add_argument("--outdir", type=Path, default=Path("xlsx"), help="Папка результатов")
parser.add_argument("--sheet", default="Sheet1", help="Имя листа")
parser.add_argument("--delimiter", help="Разделитель CSV, по умолчанию авто")
parser.add_argument("--encoding", default="utf-8-sig", help="Кодировка CSV")
parser.add_argument("--detect-types", action="store_true", help="Преобразовывать числа и даты")
parser.add_argument("--no-header", action="store_true", help="Не закреплять первую строку")
parser.add_argument("--force", action="store_true", help="Перезаписать результат")
args = parser.parse_args()
path = args.input.expanduser()
if not path.is_file():
print(f"Файл не найден: {path}", file=sys.stderr)
return 2
target = args.output.expanduser() if args.output else args.outdir.expanduser() / f"{path.stem}.xlsx"
if target.suffix.lower() != ".xlsx":
print("Итоговый файл должен иметь расширение .xlsx", file=sys.stderr)
return 2
if target.exists() and not args.force:
print(f"Файл уже существует: {target}. Добавьте --force.", file=sys.stderr)
return 2
try:
text = path.read_text(encoding=args.encoding)
except (OSError, UnicodeError) as error:
print(f"Не удалось прочитать CSV: {error}", file=sys.stderr)
return 1
delimiter = args.delimiter
if not delimiter:
try:
delimiter = csv.Sniffer().sniff(text[:4096], delimiters=",;\t|").delimiter
except csv.Error:
delimiter = ","
rows = list(csv.reader(io.StringIO(text), delimiter=delimiter))
if not rows:
print("CSV пуст", file=sys.stderr)
return 1
workbook = Workbook()
sheet = workbook.active
title = re.sub(r"[\[\]:*?/\\]", "_", args.sheet).strip()[:31] or "Sheet1"
sheet.title = title
widths: dict[int, int] = {}
for row_index, row in enumerate(rows, start=1):
for column_index, value in enumerate(row, start=1):
cell_value = convert(value) if args.detect_types else value
sheet.cell(row=row_index, column=column_index, value=cell_value)
widths[column_index] = max(widths.get(column_index, 0), len(str(cell_value)) if cell_value is not None else 0)
for column_index, width in widths.items():
sheet.column_dimensions[get_column_letter(column_index)].width = min(max(width + 2, 10), 60)
if not args.no_header:
sheet.freeze_panes = "A2"
target.parent.mkdir(parents=True, exist_ok=True)
workbook.save(target)
print(f"Готово: {target}, строк: {len(rows)}, разделитель: {delimiter!r}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.