macrocc/tools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8fb110adbdb18db88748eda71c1cae8093571e8c
tools/dexcel/README.md
T

12 KiB
Raw Blame History

dexcel - Excel 读写工具 📊

一个简单易用的命令行 Excel 处理工具，支持查询、统计、插入、更新和删除操作。

✨ 功能特性

核心操作

  • 🔍 query: 灵活查询 Excel 数据，支持行范围选择和自定义分隔符
  • 📊 count: 快速统计行数，适合脚本使用
  • ➕ insert: 插入新行，支持指定位置或追加到末尾
  • ✏️ update: 更新现有数据，支持部分列更新
  • ❌ delete: 删除行或单元格，带安全确认机制

通用特性

  • 📑 多 Sheet 支持: 所有操作都支持 --sheet 参数指定工作表
  • 🔢 负数索引: 支持负数行号（-1 表示最后一行）
  • 🆕 自动创建: insert 操作在文件不存在时自动创建
  • ⚠️ 安全确认: delete 操作需要用户确认
  • 📤 灵活输出: query 支持自定义分隔符（默认 |）

📦 安装

从源码编译

cd dexcel
cargo build --release

编译后的可执行文件位于 target/release/dexcel.exe (Windows)

全局安装

cargo install --path . --force

安装后可直接使用 dexcel 命令。

🚀 使用方法

基本格式：

dexcel <文件路径> <操作> [参数]

注意：文件路径是第一个位置参数，不需要 --file 标志！

1. 查询数据 (query)

# 查看整个文件（默认显示最后20行）
dexcel data.xlsx query

# 查看前5行
dexcel data.xlsx query 5

# 查看最后3行
dexcel data.xlsx query -3

# 查看最后一行
dexcel data.xlsx query --last

# 从第10行开始查看
dexcel data.xlsx query --start 10

# 指定 Sheet 名称
dexcel data.xlsx query --sheet "Sales"

query 参数说明

  • [COUNT]: 获取行数（正数从前，负数从后），默认0显示最后20行
  • --start <START>: 开始行号（支持负数）
  • --last: 获取最后一行
  • --sheet <SHEET>: Sheet 名称（可选，默认第一个 Sheet）

2. 统计行数 (count)

# 统计总行数
dexcel data.xlsx count

# 统计指定 Sheet 的行数
dexcel data.xlsx count --sheet "Sales"

count 参数说明

  • --sheet <SHEET>: Sheet 名称（可选，默认第一个 Sheet）

输出: 只输出一个数字，表示总行数，适合脚本中使用。

3. 插入数据 (insert)

# 创建新文件并插入表头
dexcel new-file.xlsx insert "姓名|年龄|城市"

# 追加数据到末尾
dexcel data.xlsx insert "张三|18|北京"

# 在指定位置插入（第2行）
dexcel data.xlsx insert "李四|20|上海" --row 2

# 使用不同分隔符
dexcel data.xlsx insert "王五,25,广州" --split ","

# 指定 Sheet
dexcel data.xlsx insert "数据" --sheet "Sheet2"

insert 参数说明

  • <VALUE>: 要插入的值（用 split 分隔列）必需
  • --row <ROW>: 插入位置（不指定则追加到末尾）
  • --sheet <SHEET>: Sheet 名称（可选）
  • --split <SPLIT>: 分隔符（默认 |）

4. 更新数据 (update)

# 更新整行（从第1列开始）
dexcel data.xlsx update "赵六|22|深圳" --row 2

# 更新部分列（从第2列开始）
dexcel data.xlsx update "新年龄" --row 5 --cell 2

# 更新多列（从第3列开始）
dexcel data.xlsx update "新城市|新备注" --row 4 --cell 3

# 指定 Sheet
dexcel data.xlsx update "新值" --row 1 --sheet "Sheet2"

update 参数说明

  • <VALUE>: 要更新的值（用 split 分隔列）必需
  • --row <ROW>: 行号（必需，支持负数）
  • --cell <CELL>: 起始列号（从1开始，默认1）
  • --sheet <SHEET>: Sheet 名称（可选）
  • --split <SPLIT>: 分隔符（默认 |）

5. 删除数据 (delete)

# 删除整行（带确认）
dexcel data.xlsx delete --row 5

# 删除最后一行
dexcel data.xlsx delete --row -1

# 删除单元格（第3行第2列）
dexcel data.xlsx delete --row 3 --cell 2

# 指定 Sheet
dexcel data.xlsx delete --row 1 --sheet "Sheet2"

delete 参数说明

  • [COUNT]: 删除数量（默认1）
  • --row <ROW>: 行号（必需，支持负数）
  • --cell <CELL>: 列号（可选，不指定则删除整行）
  • --sheet <SHEET>: Sheet 名称（可选）

注意: delete 操作需要用户确认（输入 y 继续）

💡 使用示例

示例 1: 创建学生信息表

# 创建表头
dexcel students.xlsx insert "姓名|年龄|班级"

# 添加学生数据
dexcel students.xlsx insert "张三|18|一班"
dexcel students.xlsx insert "李四|19|二班"
dexcel students.xlsx insert "王五|20|三班"

# 查看所有数据
dexcel students.xlsx query

# 统计总行数
dexcel students.xlsx count

示例 2: 数据查询和分析

# 查看前5行
dexcel data.xlsx query 5

# 查看最后10行
dexcel data.xlsx query -10

# 从第50行开始查看
dexcel data.xlsx query --start 50

# 导出到文件
dexcel data.xlsx query > output.txt

# 使用逗号分隔
dexcel data.xlsx query --split ","

示例 3: 数据更新

# 更新第2行的所有数据
dexcel data.xlsx update "新姓名|新年龄|新城市" --row 2

# 只更新第2行的第2列
dexcel data.xlsx update "新年龄" --row 2 --cell 2

# 批量更新（脚本）
for i in 2 3 4 5; do
    dexcel data.xlsx update "已审核" --row $i --cell 4
done

示例 4: 数据清理

# 删除错误数据行
dexcel data.xlsx delete --row 10

# 删除最后一行
dexcel data.xlsx delete --row -1

# 删除特定单元格
dexcel data.xlsx delete --row 5 --cell 3

示例 5: 多 Sheet 操作

# 在不同 Sheet 中操作
dexcel data.xlsx insert "数据1" --sheet "Sheet1"
dexcel data.xlsx insert "数据2" --sheet "Sheet2"

# 查询指定 Sheet
dexcel data.xlsx query --sheet "Sales"

# 统计指定 Sheet 的行数
dexcel data.xlsx count --sheet "Sales"

📊 输出格式

query 输出（表格格式）

┌──────┬──────┬──────┐
│ 姓名 │ 年龄 │ 城市 │
├──────┼──────┼──────┤
│ 张三 │ 25   │ 北京 │
├──────┼──────┼──────┤
│ 李四 │ 30   │ 上海 │
└──────┴──────┴──────┘

共输出 2 行数据，3 列

特点:

  • ✅ 使用美观的表格格式（基于 tabled 库）
  • ✅ 自动对齐列宽
  • ✅ 清晰的分隔线和边框
  • ✅ 显示行数和列数统计
  • ✅ 易于阅读和查看

count 输出

100

特点:

  • 只输出一个数字
  • 适合脚本中使用
  • 可与其他命令组合

操作反馈

insert 成功:

✓ 操作成功：已创建新文件并插入一行数据
  文件: data.xlsx, Sheet: Sheet1

update 成功:

✓ 操作成功：已更新第 5 行，从第 1 列开始
  文件: data.xlsx, Sheet: Sheet1

delete 成功:

✓ 操作成功：已删除第 5 行
  剩余行数: 9
  文件: data.xlsx, Sheet: Sheet1

⚙️ 技术细节

依赖库

  • calamine: Excel 文件读取库，支持 .xlsx 格式
  • rust_xlsxwriter: Excel 文件写入库，功能强大
  • clap: 命令行参数解析库
  • chrono: 日期时间处理库

工作原理

查询流程

  1. 打开 Excel 文件
  2. 选择指定的 Sheet（默认第一个）
  3. 根据参数计算读取范围
  4. 遍历单元格并提取数据
  5. 以指定分隔符格式输出

写入流程

  1. 检查文件是否存在（insert 可自动创建）
  2. 读取现有数据到新工作簿
  3. 执行插入/更新/删除操作
  4. 保存文件

数据类型支持

读取时支持:

  • 字符串 (String)
  • 整数 (Int)
  • 浮点数 (Float)
  • 布尔值 (Bool)
  • 日期时间 (DateTime) - 自动识别并格式化
  • 空值 (Empty)
  • 错误值 (Error)

写入时:

  • 所有数据都作为字符串写入

⚠️ 注意事项

  1. 索引从 1 开始: 行和列的索引都是从 1 开始，不是 0
  2. 负数索引: -1 = 最后一行/列，-2 = 倒数第二
  3. 文件自动创建: insert 操作在文件不存在时自动创建
  4. 分隔符默认: 默认使用 | 分隔列
  5. 文件格式: 仅支持 .xlsx，不支持 .xls
  6. 删除需确认: delete 操作必须用户确认才能执行
  7. 日期自动识别: 自动识别并格式化日期单元格
  8. 不可撤销: delete 操作不可撤销，请谨慎操作！

限制

读取限制:

  • 公式: 不计算公式，只读取原始值
  • 样式: 不读取单元格样式（颜色、字体等）
  • 图表: 不支持读取图表
  • 宏: 不支持 VBA 宏
  • 大文件: > 10MB 的文件可能较慢

写入限制:

  • 无样式: 不能设置颜色、字体等样式
  • 无公式: 不能写入公式
  • 覆盖警告: update 会覆盖目标单元格的原有内容
  • insert 下移: insert 会将原有数据下移

🔧 常见问题

Q1: 如何查看文件有多少行？

dexcel data.xlsx count

Q2: 如何追加多行数据？

多次调用 insert 命令：

dexcel data.xlsx insert "数据1|数据2"
dexcel data.xlsx insert "数据3|数据4"

Q3: 负数参数怎么用？

dexcel data.xlsx query -5      # 最后5行
dexcel data.xlsx delete --row -1  # 删除最后一行

Q4: 如何处理中文内容？

直接传入，完全支持 UTF-8：

dexcel data.xlsx insert "张三|18|北京"

Q5: 如何在脚本中使用 count？

# 获取行数并存储到变量
$lines = dexcel data.xlsx count

# 条件判断
if ((dexcel data.xlsx count) -gt 100) {
    Write-Host "文件超过100行"
}

Q6: 删除操作能撤销吗？

不能撤销，请谨慎操作！建议先备份文件。

🎯 应用场景

1. 数据预览

快速查看大型 Excel 文件的部分内容：

dexcel large-file.xlsx query 5

2. 数据提取

提取特定数据并导出：

dexcel data.xlsx query -10 > last-rows.txt

3. 报告生成

创建报告模板：

dexcel report.xlsx insert "月度报告||||"
dexcel report.xlsx insert "日期|销售额|利润|备注"

4. 数据更新

批量更新某列数据：

dexcel data.xlsx update "新值" --row 5 --cell 2
dexcel data.xlsx update "新值" --row 6 --cell 2

5. 数据清理

删除错误数据：

dexcel data.xlsx delete --row 10

6. 自动化脚本

PowerShell 批量导入：

$students = @(
    @("张三", "18", "一班"),
    @("李四", "19", "二班")
)

foreach ($student in $students) {
    dexcel students.xlsx insert "$($student[0])|$($student[1])|$($student[2])"
}

📝 批处理脚本示例

Windows 批量导入 (import.bat)

@echo off
echo 正在导入数据...

dexcel data.xlsx insert "ID|名称|数量"
dexcel data.xlsx insert "001|产品A|100"
dexcel data.xlsx insert "002|产品B|200"
dexcel data.xlsx insert "003|产品C|300"

echo 导入完成！
dexcel data.xlsx query
pause

PowerShell 数据处理 (process.ps1)

# 读取并处理数据
$output = dexcel data.xlsx query 100

# 过滤包含关键词的行
$filtered = $output | Select-String "关键词"

# 保存到文件
$filtered | Out-File -FilePath filtered.txt -Encoding UTF8

Write-Host "处理完成！" -ForegroundColor Green

🤝 贡献

欢迎提交 Issue 和 Pull Request！

可能的改进方向：

  • 支持更多数据类型（公式等）
  • 支持单元格样式（颜色、字体等）
  • 支持批量写入优化
  • 支持复制 Sheet
  • 添加数据验证功能
  • 支持更多输出格式（CSV, JSON 等）

📄 许可证

本项目采用 MIT 许可证。

🙏 致谢

感谢以下开源项目：

Made with ❤️ using Rust

Reference in New Issue View Git Blame Copy Permalink