6.2 代码生成与迭代：Cursor 编写核心功能

在有了清晰的需求后，我们可以利用 Cursor AI 帮助我们快速实现 VS Code 扩展的核心功能。本节将展示如何通过简单的提示词指令，让 Cursor 生成代码并进行迭代优化。

6.2.1 初始项目生成

向 Cursor 提供初始项目结构的要求是开始开发的第一步。当我们输入"根据上一节的需求文档，请使用 TypeScript 为我生成 VS Code 扩展的初始项目结构和必要的配置文件（如 package.json, tsconfig.json, extension.ts 的基本框架）。请确保包含 pdfToText.extractText 命令的注册框架和对应的激活事件"后，Cursor 会自动生成完整的项目结构，包括：

• package.json：包含扩展基本信息、激活事件和命令配置
• src/extension.ts：包含命令注册代码框架
• tsconfig.json：TypeScript 编译配置

注意：在向 Cursor 提供初始需求时，尽量详细说明你需要哪些关键文件和功能架构。这样生成的项目结构才能更符合 VS Code 扩展的标准，也便于后续开发。即使提供了详细需求，生成后也应该检查所有配置文件的内容是否正确，特别是 package.json 中的激活事件和命令注册部分。

6.2.2 核心解析功能实现

在初始项目结构的基础上，下一步是要求 Cursor 实现 PDF 解析的核心逻辑。我们向 Cursor 提供了具体的需求：“请实现以下逻辑：使用 vscode.window.showOpenDialog 让用户选择一个 PDF 文件。如果用户选择了文件，读取该文件的内容。使用 pdf-parse 库解析 PDF 内容。将解析得到的文本显示在一个新的无标题文档中。同时，请确保将 pdf-parse 添加到 package.json 的依赖中，并添加 @types/pdf-parse 到开发依赖中。” Cursor 随即实现了完整的 PDF 解析逻辑，自动更新了 package.json 中的依赖项，在 extension.ts 中实现了文件选择、解析和显示逻辑，并添加了基础的错误处理。这种方式大大简化了开发过程，使我们能够快速实现扩展的核心功能。

6.2.3 错误处理优化

实现基本功能后，我们希望优化扩展的错误处理机制。向 Cursor 提出"请优化 src/extension.ts 中的错误处理逻辑：在 try…catch 块中，更具体地捕获和报告错误信息。例如，如果 pdf-parse 失败，显示包含错误详情的 vscode.window.showErrorMessage。确保用户取消文件选择的操作不会被视为错误"的需求后，Cursor 对代码进行了针对性优化，添加了更详细的错误报告机制，正确处理了用户取消操作的情况，并为不同类型的错误提供了友好的用户提示，进一步提升了扩展的用户体验。

注意：良好的错误处理是优质扩展的关键特性。确保你的扩展能优雅地处理各种异常情况，并向用户提供清晰的错误信息。在 VS Code 扩展中，使用 vscode.window.showErrorMessage 方法来显示错误通知是推荐的做法，这样用户可以直观地看到问题所在。同时，要区分真正的错误和用户取消操作等正常行为，避免向用户显示不必要的错误提示。

6.2.4 测试与调试

完成代码开发后，需要进行测试和调试。当我们询问"如何测试我们刚刚创建的扩展？请提供运行和调试的步骤"时，Cursor 提供了完整的测试流程，如图 6-2-1 所示。测试主要包括运行 npm install 安装依赖、按 F5 启动调试模式、在新窗口中使用命令面板（Ctrl+Shift+P）执行刚创建的命令，以及如何设置断点和查看日志等步骤，帮助我们全面验证扩展功能的正确性。

图 6-2-1 VS Code 扩展调试运行过程

测试主要包括以下步骤：

• 运行 npm install 安装依赖
• 按 F5 启动调试模式
• 在新窗口中使用命令面板（Ctrl+Shift+P）执行刚创建的命令
• 如何设置断点和查看日志

6.2.5 功能迭代案例：添加转换选项

为了进一步展示 Cursor 在迭代开发中的能力，我们可以要求添加更多功能：“请为我们的扩展添加一个功能增强：在提取 PDF 文本后，让用户选择文本格式化选项，具体要求：添加一个选项菜单，包含 “原始文本”、“保留段落” 和 “移除多余空格” 三个选项；根据用户选择，对提取的文本进行相应处理；更新 UI 和命令处理逻辑”。Cursor 针对这个需求生成了相应的代码变更，实现了选项菜单显示逻辑、不同文本处理函数和更新主命令流程以包含用户选择步骤，展示了 Cursor 在功能迭代过程中的强大能力。

注意：在进行功能迭代时，尝试将需求分解为清晰的步骤，这样 Cursor 才能更准确地理解你的意图并生成符合预期的代码。如果新功能涉及到 UI 交互，明确描述交互流程和各选项的具体行为。迭代开发时，记得保留原有功能的稳定性，让新功能作为对现有代码的增强而非替代。

小结：Cursor AI 的优势

通过以上几个简单步骤，我们借助 Cursor AI 完成了整个 VS Code 扩展的核心功能开发，展现了 Cursor 在提升开发效率、保证代码质量、支持迭代优化和改善开发体验方面的优势。从零到功能完整的扩展只需几次简单的提示词交互，生成的代码规范、健壮，包含错误处理和最佳实践，我们可以快速要求 Cursor 对代码进行改进和优化，同时减少了样板代码编写和 API 查找的工作。在下一节中，我们将探讨如何借助 Cursor 为扩展添加更多高级功能和进行发布准备。