excel2json Skill

把 Excel 转成程序能直接消费的 JSON

功能描述

把工作表转换成 JSON 兼容的 Python 对象，可直接写入文件或当接口数据使用。三种结构：records（每行一个对象）、columns（每列一个数组）、values（纯二维数组）。空单元格转 null，日期时间转 ISO 字符串，重复的列名自动加 _2、_3 后缀避免覆盖。

所属分类

skills/excel/excel2json/

调用方式

from skills.excel import excel2json

data = excel2json('商品表.xlsx', orient='records', output_path='goods.json')

参数说明

参数	类型	必填	默认值	说明
`excel_path`	str	是	-	Excel 文件路径
`sheet_name`	str	否	`None`	工作表名，默认取第一个
`orient`	str	否	`'records'`	`records`、`columns` 或 `values`
`output_path`	str	否	`None`	JSON 输出路径，指定后同时写文件
`indent`	int	否	`2`	写文件时的缩进，`None` 表示压缩
`ensure_ascii`	bool	否	`False`	是否把中文转成 `\uXXXX`

返回值

list | dict：records 和 values 返回列表，columns 返回字典。

使用示例

from skills.excel import excel2json

rows = excel2json('商品表.xlsx')
print(rows[0])            # {'商品名': '苹果', '价格': 5.5}

by_column = excel2json('商品表.xlsx', orient='columns')
print(by_column['价格'])   # [5.5, 3.0, ...]

excel2json('商品表.xlsx', output_path='goods.json', ensure_ascii=False)

原始函数

contributors/my12yyds/excel2json.py

excel2json