功能

Literate Coding

直接在编辑器中使用自然语言指令编写代码,指令就放在代码应该出现的位置。Bob 通过 inline diff 在上下文中生成实现。

为什么使用 Literate Coding?

  • 保持在工作流中:无需切换到聊天界面即可编写代码
  • 保持精确控制:精确指定 AI 应在何处以何种方式修改代码
  • 自然表达意图:用自然语言或 pseudocode 描述你想要的内容
  • 提交前查看变更:查看 diff 以确保生成的代码满足需求

工作原理

当你激活 Literate Coding 模式时,可以直接在源文件中编写自然语言指令、pseudocode、注释或部分代码片段。这些指令以蓝色高亮显示,与普通代码区分开来。

当你运行 Generate 命令时,Bob 会:

  1. 分析整个文件,包括你的 Literate Coding 块
  2. 理解周围的上下文和你的意图
  3. 将你的指令替换为真实的、可执行的代码
  4. 显示 inline diff,供你审查变更

这种方法将自然语言的表达力与直接代码编辑的精确性相结合。

入门

基本用法

  1. 切换 Literate Coding 模式:
    • Cmd+I(Mac)或 Ctrl+I(Windows/Linux)
    • 或点击编辑器工具栏中的魔法棒图标
  2. 编写指令:
    • 输入 pseudocode、自然语言指令或注释
    • 文本以蓝色显示,标记为 Literate Coding 内容
  3. 生成代码:
    • Cmd+Enter(推荐)或点击 Generate 按钮
    • Bob 将指令转换为真实代码并显示 inline diff
  4. 审查并应用:
    • 接受更改:Cmd+Enter
    • 拒绝更改:Cmd+Shift+Backspace
    • 更改在接受之前已写入文件,让你可以在决定前先进行测试

了解如何使用 Literate Coding 从注释生成代码

技巧与最佳实践

  • 在指令中对需求进行具体说明
  • 包含相关上下文,例如变量类型或函数参数
  • 对于复杂逻辑,将指令拆分为更小、更集中的块
  • 将 Literate Coding 用于创建新代码和修改现有代码

当前限制

  • 单文件范围:当前每次只能处理一个文件(计划支持多文件)
  • 预览功能:样式、diffing 和 AI 行为将持续改进
这个主题怎么样?