docs(readme): 更新文档说明删除操作的灵活性和新功能
- 修改 delete 操作说明,支持更灵活的起始位置和数量控制 - 添加 -y/--yes 参数说明,用于跳过删除确认 - 更新 delete 命令使用示例和参数说明 - 添加日期智能识别功能说明 - 增加备份清理功能说明 - 更新注意事项中关于删除操作的描述 - 添加常见问题中跳过删除确认的方法 - 更新数据清理示例使用新的删除语法
This commit is contained in:
+55
-32
@@ -11,15 +11,17 @@
|
|||||||
- 📊 **count**: 快速统计行数,适合脚本使用
|
- 📊 **count**: 快速统计行数,适合脚本使用
|
||||||
- ➕ **insert**: 插入新行,支持指定位置或追加到末尾
|
- ➕ **insert**: 插入新行,支持指定位置或追加到末尾
|
||||||
- ✏️ **update**: 更新现有数据,支持部分列更新
|
- ✏️ **update**: 更新现有数据,支持部分列更新
|
||||||
- ❌ **delete**: 删除行,带安全确认机制
|
- ❌ **delete**: 删除行,支持灵活的起始位置和数量控制
|
||||||
- 🎨 **style**: 设置样式(行高、列宽、自动换行)
|
- 🎨 **style**: 设置样式(行高、列宽、自动换行)
|
||||||
|
|
||||||
### 通用特性
|
### 通用特性
|
||||||
- 📑 **多 Sheet 支持**: 所有操作都支持 `--sheet` 参数指定工作表
|
- 📑 **多 Sheet 支持**: 所有操作都支持 `--sheet` 参数指定工作表
|
||||||
- 🔢 **负数索引**: 支持负数行号(-1 表示最后一行)
|
- 🔢 **负数索引**: 支持负数行号(-1 表示最后一行)
|
||||||
- ⚠️ **安全确认**: delete 操作需要用户确认
|
- ⚠️ **安全确认**: delete 操作默认需要用户确认,可用 `-y` 跳过
|
||||||
- 💾 **样式保留**: 使用 umya-spreadsheet 库,完整保留 Excel 样式
|
- 💾 **样式保留**: 使用 umya-spreadsheet 库,完整保留 Excel 样式
|
||||||
- 📤 **表格输出**: query 以美观的表格格式显示数据
|
- 📤 **表格输出**: query 以美观的表格格式显示数据
|
||||||
|
- 📅 **日期智能**: 自动识别和格式化日期时间单元格
|
||||||
|
- 🧹 **备份清理**: 操作成功后自动删除 .bak 备份文件
|
||||||
|
|
||||||
## 📦 安装
|
## 📦 安装
|
||||||
|
|
||||||
@@ -158,27 +160,36 @@ dexcel data.xlsx update "新值" --row 1 --sheet "Sheet2"
|
|||||||
### 5. 删除数据 (delete)
|
### 5. 删除数据 (delete)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 删除前10行
|
# 删除第5行(需要确认)
|
||||||
dexcel data.xlsx delete 10
|
dexcel data.xlsx delete 5
|
||||||
|
|
||||||
# 删除后5行
|
# 从第3行开始删除5行(跳过确认)
|
||||||
dexcel data.xlsx delete -5
|
dexcel data.xlsx delete 3 --count 5 -y
|
||||||
|
|
||||||
# 删除第3到第8行
|
# 删除最后一行
|
||||||
dexcel data.xlsx delete 3 8
|
dexcel data.xlsx delete -1 -y
|
||||||
|
|
||||||
|
# 删除最后3行
|
||||||
|
dexcel data.xlsx delete -3 --count 3 -y
|
||||||
|
|
||||||
# 指定 Sheet
|
# 指定 Sheet
|
||||||
dexcel data.xlsx delete 1 --sheet "Sheet2"
|
dexcel data.xlsx delete 1 --sheet "Sheet2"
|
||||||
```
|
```
|
||||||
|
|
||||||
#### delete 参数说明
|
#### delete 参数说明
|
||||||
- `<RANGE>`: 删除范围,支持以下格式:
|
- `<START>`: 起始行号(必需,支持负数)
|
||||||
- `N` - 删除前 N 行(如 `delete 10` 删除前10行)
|
- 正数:从前往后数(如 `5` 表示第5行)
|
||||||
- `-N` - 删除后 N 行(如 `delete -10` 删除后10行)
|
- 负数:从后往前数(如 `-1` 表示最后一行)
|
||||||
- `START END` - 删除从 START 到 END 行(如 `delete 1 10` 删除第1到第10行)
|
- `--count <COUNT>`: 删除的行数(默认1)
|
||||||
|
- `-y, --yes`: 跳过确认
|
||||||
- `--sheet <SHEET>`: Sheet 名称(可选)
|
- `--sheet <SHEET>`: Sheet 名称(可选)
|
||||||
|
|
||||||
**注意**: delete 操作需要用户确认(输入 y 继续),请谨慎操作!
|
**使用示例**:
|
||||||
|
- `dexcel file.xlsx delete 5` - 删除第5行(需确认)
|
||||||
|
- `dexcel file.xlsx delete 5 --count 3 -y` - 从第5行开始删除3行(跳过确认)
|
||||||
|
- `dexcel file.xlsx delete -1 --count 2 -y` - 删除最后2行
|
||||||
|
|
||||||
|
**注意**: delete 操作默认需要用户确认(输入 y 继续),可使用 `-y` 跳过确认。
|
||||||
|
|
||||||
### 6. 设置样式 (style)
|
### 6. 设置样式 (style)
|
||||||
|
|
||||||
@@ -264,14 +275,14 @@ done
|
|||||||
### 示例 4: 数据清理
|
### 示例 4: 数据清理
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 删除前5行
|
# 删除第5行
|
||||||
dexcel data.xlsx delete 5
|
dexcel data.xlsx delete 5 -y
|
||||||
|
|
||||||
|
# 从第10行开始删除5行
|
||||||
|
dexcel data.xlsx delete 10 --count 5 -y
|
||||||
|
|
||||||
# 删除最后3行
|
# 删除最后3行
|
||||||
dexcel data.xlsx delete -3
|
dexcel data.xlsx delete -3 --count 3 -y
|
||||||
|
|
||||||
# 删除第10到第20行
|
|
||||||
dexcel data.xlsx delete 10 20
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### 示例 5: 多 Sheet 操作
|
### 示例 5: 多 Sheet 操作
|
||||||
@@ -355,9 +366,7 @@ dexcel data.xlsx style --rows 1 --row-height 20 --sheet "Sheet2"
|
|||||||
|
|
||||||
**delete 成功**:
|
**delete 成功**:
|
||||||
```
|
```
|
||||||
✓ 操作成功:已删除第 5 行到第 10 行(共 6 行)
|
✓ 已删除第 5 至 7 行(共 3 行)
|
||||||
剩余行数: 94
|
|
||||||
文件: data.xlsx, Sheet: Sheet1
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## ⚙️ 技术细节
|
## ⚙️ 技术细节
|
||||||
@@ -386,11 +395,15 @@ dexcel data.xlsx style --rows 1 --row-height 20 --sheet "Sheet2"
|
|||||||
- 浮点数 (Float)
|
- 浮点数 (Float)
|
||||||
- 布尔值 (Bool)
|
- 布尔值 (Bool)
|
||||||
- 日期时间 (DateTime) - 自动识别并格式化
|
- 日期时间 (DateTime) - 自动识别并格式化
|
||||||
|
- `2024-01-15` → 显示为 `2024-01-15`
|
||||||
|
- `2024-12-25 14:30:00` → 显示为 `2024-12-25 14:30:00`
|
||||||
|
- `14:30:00` → 显示为 `14:30:00`
|
||||||
- 空值 (Empty)
|
- 空值 (Empty)
|
||||||
- 错误值 (Error)
|
- 错误值 (Error)
|
||||||
|
|
||||||
**写入时:**
|
**写入时:**
|
||||||
- 所有数据都作为字符串写入
|
- 所有数据都作为字符串写入
|
||||||
|
- 日期时间自动识别并转换为 Excel 序列号
|
||||||
- 样式完全保留
|
- 样式完全保留
|
||||||
|
|
||||||
## ⚠️ 注意事项
|
## ⚠️ 注意事项
|
||||||
@@ -400,11 +413,11 @@ dexcel data.xlsx style --rows 1 --row-height 20 --sheet "Sheet2"
|
|||||||
3. **文件必须存在**: insert/update/delete 操作要求文件必须已存在
|
3. **文件必须存在**: insert/update/delete 操作要求文件必须已存在
|
||||||
4. **分隔符默认**: 默认使用 `|` 分隔列
|
4. **分隔符默认**: 默认使用 `|` 分隔列
|
||||||
5. **文件格式**: 仅支持 `.xlsx`,不支持 `.xls`
|
5. **文件格式**: 仅支持 `.xlsx`,不支持 `.xls`
|
||||||
6. **删除需确认**: delete 操作必须用户确认才能执行
|
6. **删除需确认**: delete 操作默认需要用户确认,可用 `-y` 跳过
|
||||||
7. **日期自动识别**: 自动识别并格式化日期单元格
|
7. **日期自动识别**: 自动识别并格式化日期单元格 (如 `2024-01-15`, `2024-12-25 14:30:00`)
|
||||||
8. **不可撤销**: delete 操作不可撤销,请谨慎操作!
|
8. **样式保留**: 使用 umya-spreadsheet 库,完整保留 Excel 样式
|
||||||
9. **删除范围**: delete 支持多种删除模式(前N行、后N行、指定范围)
|
9. **备份清理**: 操作成功后自动删除 .bak 备份文件
|
||||||
10. **样式保留**: 使用 umya-spreadsheet 库,完整保留 Excel 样式
|
10. **不可撤销**: delete 操作不可撤销,请谨慎操作!
|
||||||
11. **样式设置**: style 命令可设置行高、列宽、自动换行等样式
|
11. **样式设置**: style 命令可设置行高、列宽、自动换行等样式
|
||||||
|
|
||||||
### 限制
|
### 限制
|
||||||
@@ -445,7 +458,7 @@ dexcel data.xlsx insert "数据3|数据4"
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
dexcel data.xlsx query -5 # 最后5行
|
dexcel data.xlsx query -5 # 最后5行
|
||||||
dexcel data.xlsx delete -1 # 删除最后一行
|
dexcel data.xlsx delete -1 -y # 删除最后一行
|
||||||
```
|
```
|
||||||
|
|
||||||
### Q4: 如何处理中文内容?
|
### Q4: 如何处理中文内容?
|
||||||
@@ -471,6 +484,13 @@ if ((dexcel data.xlsx count) -gt 100) {
|
|||||||
|
|
||||||
不能撤销,请谨慎操作!建议先备份文件。
|
不能撤销,请谨慎操作!建议先备份文件。
|
||||||
|
|
||||||
|
### Q7: 如何跳过删除确认?
|
||||||
|
|
||||||
|
使用 `-y` 或 `--yes` 参数:
|
||||||
|
```bash
|
||||||
|
dexcel data.xlsx delete 5 --count 3 -y
|
||||||
|
```
|
||||||
|
|
||||||
## 🎯 应用场景
|
## 🎯 应用场景
|
||||||
|
|
||||||
### 1. 数据预览
|
### 1. 数据预览
|
||||||
@@ -502,11 +522,14 @@ dexcel data.xlsx update "新值" --row 6 --cell 2
|
|||||||
### 5. 数据清理
|
### 5. 数据清理
|
||||||
删除错误数据:
|
删除错误数据:
|
||||||
```bash
|
```bash
|
||||||
# 删除前5行
|
# 删除第5行
|
||||||
dexcel data.xlsx delete 5
|
dexcel data.xlsx delete 5 -y
|
||||||
|
|
||||||
# 删除第10到第20行
|
# 从第10行开始删除5行
|
||||||
dexcel data.xlsx delete 10 20
|
dexcel data.xlsx delete 10 --count 5 -y
|
||||||
|
|
||||||
|
# 删除最后3行
|
||||||
|
dexcel data.xlsx delete -3 --count 3 -y
|
||||||
```
|
```
|
||||||
|
|
||||||
### 6. 自动化脚本
|
### 6. 自动化脚本
|
||||||
|
|||||||
Reference in New Issue
Block a user