Разложить XLSX по CSV
Сохраняет каждый лист книги отдельным CSV-файлом с выбором разделителя.
Что делает скрипт
Скрипт открывает книгу в 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
Что понадобится
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
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.