excel2json

# excel2json Skill > 把 Excel 转成程序能直接消费的 JSON ## 功能描述 把工作表转换成 JSON 兼容的 Python 对象，可直接写入文件或当接口数据使用。 三种结构：`records`（每行一个对象）、`columns`（每列一个数组）、`values`（纯二维数组）。 空单元格转 `null`，日期时间转 ISO 字符串，重复的列名自动加 `_2`、`_3` 后缀避免覆盖。 ## 所属分类 `skills/excel/excel2json/` ## 调用方式 ```python 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` 返回字典。 ## 使用示例 ```python 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`