docs(README): 更新文档添加换行符处理功能说明

- 添加换行符支持特性说明
- 新增换行符使用示例和常见问题解答
- 扩展技术细节中的换行符智能处理说明
- 更新注意事项中关于换行处理的内容
- 添加多行文本处理的使用示例
This commit is contained in:
macro
2026-04-26 01:01:51 +08:00
parent 72c2431f0f
commit cb5d7d0768
+83
View File
@@ -22,6 +22,7 @@
- 📤 **表格输出**: query 以美观的表格格式显示数据
- 📅 **日期智能**: 自动识别和格式化日期时间单元格
- 🧹 **备份清理**: 操作成功后自动删除 .bak 备份文件
- ↩️ **换行支持**: 智能处理各种换行符格式,自动开启换行并调整行高
## 📦 安装
@@ -134,6 +135,18 @@ dexcel data.xlsx insert "数据" --sheet "Sheet2"
**注意**:insert 命令要求文件必须已存在,如果文件不存在会报错。
**换行符支持**
```bash
# 使用字面量 \n(单引号)
dexcel data.xlsx insert '第一行\n第二行\n第三行|其他列'
# 使用 PowerShell 转义(双引号 + `r`n
dexcel data.xlsx insert "Line1`r`nLine2,Col2" --split ","
# 自动开启换行并调整行高
# 无需手动设置,程序会自动检测换行符并调整
```
### 4. 更新数据 (update)
```bash
@@ -157,6 +170,15 @@ dexcel data.xlsx update "新值" --row 1 --sheet "Sheet2"
- `--sheet <SHEET>`: Sheet 名称(可选)
- `--split <SPLIT>`: 分隔符(默认 |
**换行符支持**
```bash
# 更新单元格为多行文本
dexcel data.xlsx update '新内容\n带换行' --row 5
# 自动开启换行并调整行高
dexcel data.xlsx update "Line1`nLine2" --row 3 --split ","
```
### 5. 删除数据 (delete)
```bash
@@ -318,6 +340,24 @@ dexcel data.xlsx style --rows 1 2 3 --cols 1 2 --row-height 25 --col-width 15 --
dexcel data.xlsx style --rows 1 --row-height 20 --sheet "Sheet2"
```
### 示例 7: 处理多行文本
```bash
# 插入带换行的内容(单引号中使用 \n)
dexcel data.xlsx insert '地址:北京市\n朝阳区\n建国路100号|备注'
# 使用 PowerShell 转义符(双引号中使用 `r`n)
dexcel data.xlsx insert "Line1`r`nLine2`r`nLine3,Col2" --split ","
# 更新为多行文本
dexcel data.xlsx update '说明:第一项\n说明:第二项' --row 2
# 程序会自动:
# 1. 识别并转换所有换行格式(\r\n, \n, `r`n
# 2. 开启单元格的自动换行功能
# 3. 根据行数自动调整行高(每行约15磅)
```
## 📊 输出格式
### query 输出(表格格式)
@@ -405,6 +445,12 @@ dexcel data.xlsx style --rows 1 --row-height 20 --sheet "Sheet2"
- 所有数据都作为字符串写入
- 日期时间自动识别并转换为 Excel 序列号
- 样式完全保留
- **换行符智能处理**
- 真正的 `\r\n` (ASCII 13+10) → 转换为 `\n`
- 字面量 `\r\n` (4个字符) → 转换为 `\n`
- 字面量 `\n` (2个字符) → 转换为 `\n`
- 自动开启单元格自动换行
- 自动调整行高(每行约15磅)
## ⚠️ 注意事项
@@ -419,6 +465,7 @@ dexcel data.xlsx style --rows 1 --row-height 20 --sheet "Sheet2"
9. **备份清理**: 操作成功后自动删除 .bak 备份文件
10. **不可撤销**: delete 操作不可撤销,请谨慎操作!
11. **样式设置**: style 命令可设置行高、列宽、自动换行等样式
12. **换行处理**: insert/update 自动处理换行符,开启自动换行并调整行高
### 限制
@@ -491,6 +538,42 @@ if ((dexcel data.xlsx count) -gt 100) {
dexcel data.xlsx delete 5 --count 3 -y
```
### Q8: 如何处理多行文本?
**方法 1: 使用单引号 + 字面量 \n**
```bash
dexcel data.xlsx insert '第一行\n第二行\n第三行'
```
**方法 2: 使用 PowerShell 双引号 + `` `r`n ``**
```powershell
dexcel data.xlsx insert "Line1`r`nLine2`r`nLine3"
```
**方法 3: 使用 Bash/Shell**
```bash
dexcel data.xlsx insert $'Line1\nLine2\nLine3'
```
程序会自动:
- ✅ 识别并转换所有换行格式
- ✅ 开启单元格自动换行
- ✅ 根据行数自动调整行高(每行约15磅)
- ✅ 保留原有样式不变
### Q9: 行高会自动调整吗?
是的!当检测到单元格包含换行符时,程序会:
1. 计算行数(换行符数量 + 1
2. 估算所需行高(每行约15磅)
3. 只在当前行高小于估算值时才调整
4. 不会覆盖用户手动设置的行高
如果需要精确控制行高,可以使用 style 命令:
```bash
dexcel data.xlsx style --rows 5 --row-height 50
```
## 🎯 应用场景
### 1. 数据预览