# 用腾讯云WorkBuddy从零开发Word转Markdown功能：AI代码审查帮我抓出6个隐藏Bug

## 前言

作为一名后端开发工程师，最近接到一个需求：在现有项目中实现 Word（.doc/.docx）转 Markdown 功能。技术栈是 Java 1.8 + Spring Boot 2.3.12 + Apache POI 3.17，前端用 Vue 2.6.10 + Element UI 2.13.0 + marked@4。

传统做法是自己闷头写，写完提测，测试提Bug，我再改，来回折腾。这次我试着全程用腾讯云 WorkBuddy 搭配开发，从需求分析、代码生成到代码审查，结果让我意外——**AI 代码审查一次性帮我抓出了 6 个隐藏Bug**，其中有些是我写的时候根本没意识到的。

这篇文章记录完整流程和踩坑经验，希望对你有参考价值。

---

## 一、整体开发流程

| 阶段 | 传统方式 | 用 WorkBuddy |
|------|---------|-------------|
| 需求拆解 | 自己想，容易遗漏边界条件 | 自然语言描述需求，AI 帮你补全异常场景 |
| 后端代码编写 | 手写 Controller/Service/ServiceImpl | 给出框架路径和分层规范，AI 生成代码骨架，再人工微调 |
| 前端UI编写 | 手写 Vue 组件 + Element UI 配置 | 描述 UI 需求，AI 生成模板代码 |
| 代码审查 | 等测试提Bug，或同事CR时发现 | **AI 即时审查，秒级反馈** |

**效率对比**：以前类似功能从开发到提测大概需要 2-3 天，这次用 WorkBuddy 从需求到完成开发 + 代码审查，**半天搞定**。

---

## 二、实战步骤：从需求到代码

### 2.1 后端：Controller → Service → ServiceImpl 分层架构

我向 WorkBuddy 描述了项目已有的分层规范：

```
我的项目是 resence-cloud，后端框架路径为：
- Controller 层继承 BaseController
- Service 层定义接口
- ServiceImpl 层实现逻辑

需求：用 Apache POI 3.17 的 XWPFDocument 解析 Word 文件，
转为 Markdown 格式返回给前端。
```

WorkBuddy 按照我的分层规范，生成了三个层的代码骨架。我重点微调了 Word 解析的核心逻辑——标题层级、列表、表格、粗体斜体等 Markdown 格式转换。

### 2.2 前端：Vue + Element UI 上传组件

前端需求比较直接：一个文件上传组件 + Markdown 预览区域。我描述了需要的效果：

```
前端使用 Vue 2.6.10 + Element UI 2.13.0 + marked@4
需要一个文件上传区域（支持 .doc/.docx）
上传后调用后端接口，返回 Markdown 文本
用 marked 渲染预览
```

AI 生成的前端代码基本可用，我调整了上传按钮样式和预览区域的布局。

---

## 三、重点来了：AI 代码审查抓出的 6 个 Bug

这是最让我惊喜的部分。开发完成后，我让 WorkBuddy 对生成的代码做一轮审查，结果发现了 **6 个具体问题**：

### Bug 1：`el-descriptions` 组件版本不兼容

**问题**：前端代码中使用了 `<el-descriptions>` 组件展示文件信息，但 Element UI 2.13.0 **不支持**这个组件（它是 Element Plus 才有的）。

**修复**：改用 `<el-table>` 或 `<el-form>` 替代。

> 💡 踩坑经验：AI 生成前端代码时，可能会混入 Element Plus 的组件。一定要确认你项目实际使用的 Element UI 版本。

### Bug 2：删除线逻辑错误

**问题**：Word 中的删除线（`<w:strike>`）转 Markdown 时，逻辑判断写反了——没有删除线的文本反而被加上了 `~~` 包裹。

**修复**：修正条件判断逻辑。

```java
// 错误写法
if (!run.isStrikeThrough()) {
    markdown.append("~~").append(text).append("~~");
}

// 正确写法
if (run.isStrikeThrough()) {
    markdown.append("~~").append(text).append("~~");
}
```

### Bug 3：死代码（Dead Code）

**问题**：ServiceImpl 中有一段解析 Word 图片的代码，但对应的方法从未被调用，属于死代码。

**修复**：删除无用代码，保持代码整洁。

### Bug 4：`before-upload` 钩子未触发

**问题**：前端 `<el-upload>` 组件的 `:before-upload` 钩子绑定了方法，但方法内部逻辑有误，导致文件类型校验从未生效——用户实际上可以上传任意类型文件。

**修复**：修正校验逻辑，确保只允许 `.doc` 和 `.docx` 文件。

```javascript
// 修复前（永远返回 true）
beforeUpload(file) {
    const isDoc = file.type === 'application/msword';
    return true;  // 逻辑被跳过
}

// 修复后
beforeUpload(file) {
    const isDoc = file.name.endsWith('.doc') || file.name.endsWith('.docx');
    if (!isDoc) {
        this.$message.error('只能上传 Word 文件！');
        return false;
    }
    return true;
}
```

### Bug 5：`handleExceed` 方法缺失

**问题**：`<el-upload>` 配置了 `:limit="1"` 和 `:on-exceed="handleExceed"`，但 `handleExceed` 方法未定义。当用户超出上传限制时会报错。

**修复**：补全方法。

```javascript
handleExceed() {
    this.$message.warning('只能上传一个文件，请先删除已上传文件');
}
```

### Bug 6：`marked@4` 的 `sanitize` 选项已弃用

**问题**：前端使用 `marked@4` 渲染 Markdown 时，代码中传入了 `sanitize: true` 选项。但 **marked v4 已弃用 sanitize 选项**，传了也不会生效，而且会在控制台打出警告。

**修复**：移除 `sanitize` 选项，改用 DOMPurify 等 XSS 防护方案。

```javascript
// 修复前
marked(markdownText, { sanitize: true });

// 修复后
import DOMPurify from 'dompurify';
const html = marked(markdownText);
const cleanHtml = DOMPurify.sanitize(html);
```

---

## 四、踩坑总结

| 坑 | 严重程度 | 发现方式 | 自己写能发现吗 |
|----|---------|---------|--------------|
| el-descriptions 版本不兼容 | 🔴 高 | AI代码审查 | 大概率到运行时才报错 |
| 删除线逻辑写反 | 🔴 高 | AI代码审查 | 可能在测试时才发现 |
| 死代码 | 🟡 中 | AI代码审查 | 代码review时可能忽略 |
| before-upload 未生效 | 🔴 高 | AI代码审查 | 很难发现，看起来代码"正常" |
| handleExceed 缺失 | 🟡 中 | AI代码审查 | 边界场景测试才能覆盖 |
| marked sanitize 弃用 | 🟡 中 | AI代码审查 | 运行时有控制台警告但不报错 |

**最关键的是 Bug 4 和 Bug 1**：这两个问题表面看起来代码是"对"的，只有在特定场景下才会暴露。如果是人工 Review，大概率会漏掉。

---

## 五、WorkBuddy 使用技巧

经过这次实践，我总结了几个让 WorkBuddy 发挥最大价值的使用技巧：

### 5.1 描述需求时，给够上下文

不要只说"帮我写个上传接口"，而是告诉 AI：

- 你的项目分层规范（Controller → Service → ServiceImpl）
- 技术栈版本号（Java 1.8、Spring Boot 2.3.12、Element UI 2.13.0）
- 已有的基类或工具类（继承 BaseController）

**版本号尤其重要**，上面 Bug 1 和 Bug 6 都是因为版本差异导致的。

### 5.2 开发完成后，一定要做 AI 代码审查

不要只把 WorkBuddy 当代码生成器用。它最强大的能力之一是**代码审查**——它能从逻辑正确性、API 兼容性、边界处理等多个维度检查你的代码。

审查指令示例：

```
请对我刚写的 Word 转 Markdown 代码进行审查，重点关注：
1. API 兼容性（Apache POI 3.17、Element UI 2.13.0、marked@4）
2. 逻辑正确性（格式转换是否准确）
3. 边界处理（空文件、大文件、异常格式）
4. 前后端联调可能的问题
```

### 5.3 多轮迭代，逐步细化

第一轮生成的代码可能不完美，但这没关系。你可以：
1. 先让 AI 生成骨架代码
2. 人工调整业务逻辑
3. 让 AI 审查修正后的代码
4. 针对审查意见逐项修复

这种"人机协作"模式比纯手写或纯AI生成都高效。

### 5.4 善用 WorkBuddy 的金融数据查询能力

除了开发，WorkBuddy 还内置了金融数据查询能力。作为开发者，有时候需要查一些行业数据做技术选型参考，比如某个开源库的社区活跃度、竞品对比等，直接用自然语言问就行。

---

## 六、写在最后

WorkBuddy 不是要替代开发者，而是把重复性的、容易出错的环节交给 AI，让开发者把精力放在核心业务逻辑上。这次 Word 转 Markdown 的开发，最让我受益的不是 AI 帮我写了多少代码，而是**代码审查环节帮我避免了线上事故**——如果删除线逻辑 Bug 和上传校验 Bug 流入生产环境，排查成本远大于现在。

如果你也在用 WorkBuddy，强烈建议开发完成后加一轮代码审查，这个习惯值 100 个积分。

---

*#WorkBuddy #AI编程 #代码审查 #Java #Vue*


作为一名后端开发工程师，最近接到一个需求：在现有项目中实现 Word（.doc/.docx）转 Markdown 功能。技术栈是 Java 1.8 + Spring Boot 2.3.12 + Apache POI 3.17，前端用 Vue 2.6.10 + Element UI 2.13.0 + marked@4。

用腾讯云WorkBuddy从零开发Word转Markdown功能：AI代码审查帮我抓出6个隐藏Bug

通过workbuddy编写将word转写为markdown的实践，markdown更便于传递给大模型进行分析使用。

人工智能

后端

开发工具

腾讯云WorkBuddy助力Word转Markdown功能开发，AI代码审查一次性精准识别6个隐藏Bug，包括ElementUI版本不兼容、删除线逻辑写反、文件上传校验失效等严重问题。通过人机协作模式，半天完成从需求分析到代码审查全流程，有效避免线上事故，提升开发效率与代码质量。分享WorkBuddy实用技巧，助您告别重复劳动。

人机协作

WorkBuddy 

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

腾讯云WorkBuddy助力Word转Markdown功能开发，AI代码审查一次性精准识别6个隐藏Bug，包括ElementUI版本不兼容、删除线逻辑写反、文件上传校验失效等严重问题。通过人机协作模式，半天完成从需求分析到代码审查全流程，有效避免线上事故，提升开发效率与代码质量。分享WorkBuddy实用技巧，助您告别...

用腾讯云WorkBuddy从零开发Word转Markdown功能：AI代码审查帮我抓出6个隐藏Bug-腾讯云开发者社区-腾讯云

用腾讯云WorkBuddy从零开发Word转Markdown功能：AI代码审查帮我抓出6个隐藏Bug

用腾讯云WorkBuddy从零开发Word转Markdown功能：AI代码审查帮我抓出6个隐藏Bug

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐