Офис и PDF

Разложить XLSX по CSV

Сохраняет каждый лист книги отдельным CSV-файлом с выбором разделителя.

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

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

Скрипт открывает книгу в read-only режиме и выгружает все листы или только указанный. Формулы можно заменить кэшированными значениями флагом --values-only. Имена файлов очищаются от недопустимых символов, существующие CSV не перезаписываются без --force.

Перед запуском
  • Флаг --values-only берёт кэш Excel. Без сохранённого кэша формулы будут пустыми.
Запуск

Быстрый старт

python xlsx_to_csv.py book.xlsx

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python xlsx_to_csv.py report.xlsx --sheet Data --delimiter ";"
  • python xlsx_to_csv.py book.xlsx --values-only --outdir export
Зависимости

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

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
Исходник

xlsx_to_csv.py

#!/usr/bin/env python3
"""Экспорт листов XLSX в CSV."""
from __future__ import annotations

import argparse
import csv
import re
import sys
from datetime import date, datetime, time
from pathlib import Path

from openpyxl import load_workbook


def safe_name(name: str) -> str:
    cleaned = re.sub(r'[\\/:*?"<>|]+', "_", name).strip()
    return cleaned or "sheet"


def format_value(value: object) -> str:
    if value is None:
        return ""
    if isinstance(value, bool):
        return "TRUE" if value else "FALSE"
    if isinstance(value, (datetime, date, time)):
        return value.isoformat()
    return str(value)


def main() -> int:
    parser = argparse.ArgumentParser(description="Экспортировать листы XLSX в CSV")
    parser.add_argument("input", type=Path, help="Исходный XLSX")
    parser.add_argument("--sheet", help="Только один лист")
    parser.add_argument("--delimiter", default=",", help="Разделитель CSV")
    parser.add_argument("--values-only", action="store_true", help="Брать кэшированные значения формул")
    parser.add_argument("--encoding", default="utf-8-sig", help="Кодировка CSV")
    parser.add_argument("--outdir", type=Path, default=Path("csv"), 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

    try:
        workbook = load_workbook(filename=str(path), read_only=True, data_only=args.values_only)
    except Exception as error:
        print(f"Не удалось открыть XLSX: {error}", file=sys.stderr)
        return 1

    names = workbook.sheetnames
    if args.sheet:
        if args.sheet not in names:
            print(f"Лист не найден: {args.sheet}", file=sys.stderr)
            workbook.close()
            return 2
        names = [args.sheet]

    outdir = args.outdir.expanduser()
    saved = 0
    try:
        for name in names:
            target = outdir / f"{path.stem}_{safe_name(name)}.csv"
            if target.exists() and not args.force:
                print(f"Пропуск, уже существует: {target}")
                continue
            sheet = workbook[name]
            target.parent.mkdir(parents=True, exist_ok=True)
            rows = 0
            with target.open("w", encoding=args.encoding, newline="") as handle:
                writer = csv.writer(handle, delimiter=args.delimiter)
                for row in sheet.iter_rows(values_only=True):
                    writer.writerow([format_value(value) for value in row])
                    rows += 1
            saved += 1
            print(f"Готово: {target} ({rows} строк)")
    finally:
        workbook.close()

    if saved == 0:
        print("Ни один лист не выгружен")
        return 1
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

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

CLI 1.0.0

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

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

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

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

Категория

Офис и PDF

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

Теги