> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 重构、Docstring 等

> 使用由 Command 驱动的功能，例如用于重构的 code lens、用于生成 docstring 的工具，以及用于跨语言代码翻译的 Smart Paste。

Command 为一些常见操作提供了更简洁流畅的体验。

<div id="function-refactors-and-docstring-generation">
  ## 函数重构与文档字符串生成
</div>

在函数和类的上方，Windsurf 会渲染“代码镜头”（*code lenses*），
它们是可点击的小型文本标签，可对相应条目调用 Windsurf 的 AI 能力。

<Tip>你可以点击代码镜头文本右侧的 `✕` 来禁用代码镜头。</Tip>

`Refactor` 和 `Docstring` 这两个代码镜头会触发 Command。

* 点击 `Refactor` 后，Windsurf 会通过下拉菜单提供一组可选择的、预填好的
  指令供你挑选，也可以自定义编写。其效果等同于选中该函数后调用 Command。
* 点击 `Docstring` 后，Windsurf 会在函数定义上方为你生成一段文档字符串。
  （在 Python 中，文档字符串会正确生成在函数定义的\_下方\_。）

<Frame caption="让代码更易读、更易维护，从每一条文档字符串开始。">
  <video autoPlay muted loop playsInline src="https://mintcdn.com/codeium/d8O4q6w3H2CjrirL/assets/jetbrains_docstrings.mp4?fit=max&auto=format&n=d8O4q6w3H2CjrirL&q=85&s=508c5797d57e88cf7b7db1c07a1e45c7" data-path="assets/jetbrains_docstrings.mp4" />
</Frame>

<div id="smart-paste">
  ## 智能粘贴
</div>

此功能允许你复制代码并将其粘贴到 IDE 中以另一种编程语言编写的文件中。
使用 `⌘+⌥+V`（Mac）或 `Ctrl+Alt+V`（Windows/Linux）来触发智能粘贴。
在幕后，Windsurf 会检测目标文件的语言，并使用 Command 将剪贴板中的代码转换为对应语言。
Windsurf 的上下文感知会尽量让代码无缝融入你的项目，例如自动引用正确的变量名。

<Frame>
  <video autoPlay muted loop playsInline src="https://exafunction.github.io/public/videos/demos/Smart_Paste_Demo_1080p.mp4" />
</Frame>

一些典型用例：

* **迁移代码**：将 JavaScript 重写为 TypeScript，或将 Java 迁移到 Kotlin。
* **从 Stack Overflow 粘贴**：你在网上找到一个用 Go 编写的工具函数，但你的项目使用的是 Rust。
* **学习一门新语言**：你对 Haskell 感到好奇，想看看如果用它来编写，你的代码会是什么样子。