Офис и PDF

Преобразовать CSV в XLSX

Создаёт книгу Excel из CSV, настраивает ширину колонок и закрепляет шапку.

Python Windows macOS Linux Новичок
Скачать csv_to_xlsx.py
Описание

Что делает скрипт

Скрипт читает 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-types
  • python csv_to_xlsx.py data.csv --delimiter ";" --sheet Data
Зависимости

Что понадобится

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
openpyxl
Windows py -m pip install openpyxl
macOS python3 -m pip install openpyxl
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get office-csv-to-xlsx
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Офис и PDF

PDF, Word, Excel, презентации, документы и печать.

Теги