TRAE集成飞书CLI生成文档乱码问题解决及分析

• 有无乱码的关键区别

有乱码的方法（直接管道传输）：

Get-Content -Path “spider_design_v2.md” -Encoding UTF8 | lark-cli docs +create –title “文档标题” –markdown –

无乱码的方法（分步创建）：

# 1. 先创建空白文档$result = lark-cli docs +create --title "文档标题" --markdown " "$docId = ($result | ConvertFrom-Json).data.doc_id# 2. 读取文件内容$content = Get-Content -Path "spider_design_v2.md" -Raw -Encoding UTF8# 3. 更新文档内容lark-cli docs +update --doc $docId --markdown $content --mode overwrite

• 根本原因

1. 命令处理机制不同

1. +create 使用标准输入（stdin）接收内容时，编码转换可能不够稳定

2. +update 使用 --markdown 参数直接接收内容，编码处理更可靠

2. PowerShell 管道编码问题

1. PowerShell 管道传输时，即使设置了 UTF-8 编码，在某些情况下仍可能发生编码转换

2. 管道传输涉及多个编码转换步骤：文件 → PowerShell → 管道 → CLI 工具

3. 命令行参数 vs 标准输入

1. --markdown $content 作为命令行参数传递，编码处理更直接

2. 标准输入（-）需要经过额外的管道处理，增加了编码转换的风险

4. 飞书CLI 的编码处理差异

1. +create 和 +update 命令可能使用不同的编码处理逻辑

2. +update 命令在处理参数传递时的编码处理可能更加完善

• 技术细节

• 最佳实践建议

对于包含中文的长文本内容，推荐使用分步创建方法：

# 1. 创建空白文档$result = lark-cli docs +create --title "文档标题" --markdown " "$docId = ($result | ConvertFrom-Json).data.doc_id# 2. 读取内容（使用 -Raw 和 UTF8）$content = Get-Content -Path "文件名.md" -Raw -Encoding UTF8# 3. 更新文档内容lark-cli docs +update --doc $docId --markdown $content --mode overwrite

这种方法避免了管道传输的编码转换问题，确保中文内容能够正确显示。