编写和编辑源代码

• 要在当前行之后添加一行，请按 Ctrl+Shift+Enter。 DataSpell 将文本光标移动到下一行。

• 要在当前行上方添加一行，请按 Ctrl+Alt+Enter。 DataSpell 将文本光标移动到上一行。

• 要复制一行，请按 Ctrl+D。

• 要在整个文件或代码选择中按字母顺序排序行，请前往 编辑 | 排序行 或 编辑 | 反转行。 当您处理属性文件、数据集、文本文件、日志文件等内容时，这些操作可能会有所帮助。 如果您需要为这些操作分配快捷键，请参阅 配置键盘快捷键 了解更多信息。

• 要删除一行，请将文本光标放在您需要的行上，然后按 Ctrl+Y。

• 要合并行，请将文本光标置于您要将其他行合并到的行上，然后按 Ctrl+Shift+J。 一直按住这些键，直到所有需要的元素都被连接起来。

  您还可以连接字符串字面量、字段或变量声明以及语句。 请注意，DataSpell 会检查代码样式设置，并消除不必要的空格和多余的字符。

• 要将字符串字面量拆分为两部分，请按 Enter。

  DataSpell 会拆分字符串并提供正确的语法。 您还可以使用 在“\n”处断开字符串 意图来拆分字符串字面量。 按 Alt+Enter 或点击 以选择此意图。

• 要注释一行代码，请将文本光标放置在适当的行并按 Ctrl+/。 请再次按 Ctrl+/ 以取消注释。

• 要上下移动一行，请分别按 Alt+Shift+Up 或 Alt+Shift+Down。 在 Jupyter 笔记本中移动行时，选定的行会被转移到代码单元中，忽略中间的任何 Markdown 单元。

• 要将代码元素向左移动（交换）或向右移动，请将文本光标放在该元素上，或选中该元素并按下 Ctrl+Alt+Shift+Left 向左移，按下 Ctrl+Alt+Shift+Right 向右移。

• 当您复制 (Ctrl+C) 或剪切 (Ctrl+X) 一行且未选择任何代码时，粘贴操作将把剪贴板的内容添加到当前行的上方，而不是在您的插入点处。

  如果您想将复制的代码粘贴到文本光标处，请在 高级设置中选择 粘贴到插入符位置 选项。

• 将文本光标放置在一行或一个符号上，右键点击以打开上下文菜单，选择 复制/粘贴特殊 | 复制引用。 当您选择 复制引用 （Ctrl+Alt+Shift+C ）选项时，DataSpell 会创建一个包含所选行或符号行号的引用字符串。 您可以按 Ctrl+V 将复制的引用粘贴到任何位置。

• DataSpell 记录您复制到剪贴板的所有内容。 要从历史记录中粘贴，在编辑器中，从上下文菜单中选择 复制/粘贴特殊 | 从历史记录粘贴 (Ctrl+Shift+V)。 在打开的对话框中，选择您的条目并点击 粘贴。

• 当您将代码复制粘贴到编辑器时，DataSpell 会显示以 Unicode 名称缩写表示的隐藏（特殊）字符。

选择代码结构

• 在编辑器中，将文本光标放在您要选择的项目上，然后按 Ctrl+W/Ctrl+Shift+W 以扩展或缩小您的选择。

  例如，在纯文本文件中，选中部分从整个单词开始，然后扩展到句子、段落，等等。

• 如果需要高亮显示大括号，请将插入符号置于代码块闭合的大括号或中括号之后，或代码块起始的大括号或中括号之前。

根据大小写选择代码

1. 在 设置 对话框（Ctrl+Alt+S ）中，前往 编辑器 | 常规 | 智能键。

2. 请选择 使用"CamelHumps" 单词 复选框。

如果您希望根据大小写通过双击选择单词，请确保也选中紧接其下方的 在通过双击进行选择时允许"CamelHumps" 单词 复选框。

选择出现的内容

您可以快速定位文件中所选元素的所有出现位置，进行多重选择，或选择下一个或上一个出现位置。

• 要在文件中多重选择出现位置，请在代码中选择所需的元素，然后按 Alt+J。 按相同的键以查找下一个出现位置。

  或者，按住 Shift+Alt ，双击或拖动您想要添加到选择中的文本。

• 要将插入符移动到下一个或上一个出现位置，请按 F3/Shift+F3。

  当您按下 F3 时，DataSpell 会自动取消当前出现位置的选择并选择下一个。

• 要选择文件中的所有出现位置，请按 Ctrl+Alt+Shift+J。

• 通过在编辑器中拖动代码片段来移动和复制它们。

  • 要移动代码片段，选中它并将其拖动到目标位置。

  • 要复制代码选择，请按住 Ctrl 并将其拖动到目标位置。

  默认启用拖动功能。 要禁用它，请在 设置 对话框（Ctrl+Alt+S ）中，转到 编辑器 | 常规 ，并在 鼠标控制 部分中清除 通过拖放移动代码片段 复选框。

• 要切换所选代码片段的大小写，请按 Ctrl+Shift+U。

  请注意，当您对 CamelCase命名格式应用切换大小写操作时，DataSpell会将名称转换为小写。

• 要注释或取消注释代码片段，请选择它并按 Ctrl+Shift+/。

  要配置注释行为的设置，请使用 注释代码 部分中的选项，在 代码生成 选项卡中，该选项卡位于语言特定页面的 文件 | 设置 | 编辑器 | 代码样式 下。

启用 ML 补全排序

1. 按 Ctrl+Alt+S 打开设置并选择 编辑器 | 常规 | 代码完成。

2. 在 机器学习辅助补全 下，启用 根据机器学习对补全建议进行排序 选项并选择您希望使用 ML 补全的语言。

启用相关性标记

1. 按 Ctrl+Alt+S 打开设置并选择 编辑器 | 常规 | 代码完成。

2. 启用以下选项：

   • 在补全弹出窗口中标记位置更改 ：使用 和 图标来指示建议的重要性是增加还是减少，因此建议已在建议列表中上移或下移。

   • 在补全弹出窗口中标记最相关的条目 ：请使用 图标标识列表中最合适的建议。

   建议列表将如下显示，图标标记重新排序和最相关的条目。

   

• 要添加或删除多个插入符，请按住 Shift+Alt 并单击插入符的下一个位置。

  或者，要添加多个插入符，您可以按两次 Ctrl ，然后在不释放它的情况下，按 上 或 下 箭头键。 您还可以通过按 Shift+Alt 并拖动插入符来进行多重选择。

• 要删除所有添加的插入符，请按 Escape。

• 您可以对列中的代码进行多重选择。 要启用或禁用列选择模式，请按 Alt+Shift+Insert 或使用编辑器的上下文菜单。

  当您想同时编辑多行代码时，此模式非常有用。 将插入符放在您需要的符号上，然后向上或向下拖动，或者选择一段代码并按指定的快捷键以实现相同的结果。

  您可以更改按下 Alt+↑/↓ 时插入符移动的行为。 默认行为是将插入符移动到当前单词的末尾。 要更改此设置，请打开设置 Ctrl+Alt+S 并导航到 编辑器 | 常规。 在 插入符移动 部分中，从列表中选择适当的行为。

  

配置参数提示

1. 打开 设置 对话框（Ctrl+Alt+S ），然后转到 编辑器 | 内联提示。

2. 展开 <required language> 下的 参数名称。

3. 通过选择相应的复选框指定您希望显示参数提示的上下文。

   预览显示了您在设置中所做的更改如何影响代码外观。

4. 对于某些方法和函数，DataSpell 在任何情况下都不会显示参数提示。 请点击 排除列表... 查看这些方法和函数，可能启用参数提示，或者向列表中添加新项目。

展开或折叠代码元素

• 要折叠或展开代码片段，请按 Ctrl+NumPad -/Ctrl+NumPad +。 DataSpell 折叠或展开当前的代码片段，例如某个方法。

• 若要折叠或展开所有代码片段，请按 Ctrl+Shift+NumPad -/Ctrl+Shift+NumPad +。

  DataSpell 折叠或展开选定内容中的所有片段，或者，如果没有选定内容，则折叠或展开当前文件中的所有片段，例如，文件中的所有方法。

• 要递归折叠或展开代码，请按 Ctrl+Alt+NumPad -/Ctrl+Alt+NumPad +。 DataSpell 收起或展开当前片段及其片段内所有从属区域。

• 要折叠一对匹配的大括号内的代码块 {} ，请按 Ctrl+NumPad -。 要展开该块，请按 Ctrl+NumPad +。

• 要折叠或展开当前文件中的文档注释，请在主菜单中选择 代码 | 代码折叠 | 展开文档注释 或 折叠文档注释。

• 若要折叠或展开自定义代码片段，请选择它并按 Ctrl+.。 或者，将代码片段标记为 自定义折叠区域。

  您可以折叠或展开代码中任何手动选择的区域。

折叠或展开嵌套片段

• 要展开当前片段及所有嵌套片段，请按 Ctrl+NumPad *, 1。 您可以将当前片段扩展到指定的嵌套级别（从 1 到 5）。

• 如需展开文件中所有折叠的片段，请按 Ctrl+Shift+NumPad *, 1。 您可以展开折叠的片段直到指定的嵌套级别（从 1 到 5）。

自定义折叠区域

您可以通过使用专门的注释将任何代码片段标记为 custom folding region ，使其可折叠。 之后，您可以使用 Ctrl+. 展开和收起片段，或在打开文件时自动收起片段。

1. 在编辑器中，选择一个代码片段并按 Ctrl+Alt+T。

2. 从弹出菜单中选择 注释 或 region…endregion 注释。

3. 可选地，指定一个描述，该描述将隐藏折叠的片段。

4. 要折叠或展开创建的区域，请按 Ctrl+.。

5. 要导航到创建的自定义区域，请按 Ctrl+Alt+.。

配置代码折叠图标

您可以选择如何显示出现在行号栏中的折叠图标，或完全禁用它们。

1. 按 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 常规 | 代码折叠。

2. 从 显示代码折叠箭头 列表中，选择 始终 或 鼠标悬停时。

   取消选中复选框以禁用图标。

配置自动保存行为

1. 按 Ctrl+Alt+S 打开设置，然后选择 外观和行为 | 系统设置。

2. 在 同步外部更改 下，配置以下选项：

   • 切换到其他应用程序或内置终端时保存文件

   • 如果 IDE 空闲 N 秒，则保存文件

标记未保存更改的文件

1. 按 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 通用 | 编辑器选项卡。

2. 请选择 标记已修改(*) 复选框。

还原更改

• 对于最近的更改，包括 重构 ，请按 Ctrl+Z 或从菜单中选择 编辑 | 撤销。

• 要查看过去更详细的更改，请使用 本地历史记录。

• 为了最强大的所有更改跟踪，使用 版本控制系统。

保存时运行操作

1. 要为当前项目配置自动保存操作，请在 设置 对话框（Ctrl+Alt+S ）中打开 工具 ｜ 保存时的操作。

   要配置新项目的操作，请转到主菜单中的 文件 | 新建项目设置 | 新项目设置 | 工具 | 保存时的操作。

2. 请在保存时触发的操作旁选中复选框：

   • 重新格式化代码 ：根据您当前的代码样式设置重新格式化代码。

   • 优化导入 ：删除未使用的导入并根据当前的代码风格设置组织导入语句。

   • 上传到默认服务器 ：将已修改的文件上传到默认部署服务器。

3. 对于某些操作，您可以更精确地配置设置。 要执行此操作，请将鼠标悬停在操作上，然后点击配置链接。

   例如，对于代码重格式化，您可以指定不想更改的文件和文件夹。 将鼠标悬停在操作上，然后点击 配置作用域… 以排除特定文件和文件夹的格式化。

   您还可以选择重新格式化整个文件或仅修改的行。

4. 应用更改并关闭对话框。

启用必要的操作后，它们将在每次保存时（自动保存、通过 Ctrl+S 显式保存或通过选择 文件 | 全部保存 触发）自动执行，帮助您处理项目。

重命名

1. 在编辑器中，选择您想要重命名的元素。 如果您需要重命名文件，请在 Project 工具窗口中选择一个。

2. 按 Shift+F6 或转到 代码 | 重构 | 重命名。

3. 在 重命名对话框中，输入元素的新名称以启用 预览 和 重构 按钮。

   

   您可以指定其他选项。 例如，指定在哪里搜索元素的出现，或要重命名什么。 您还可以指定重构的范围。

4. 点击 预览 查看潜在的更改或点击 重构。

   当您点击 预览 时，DataSpell 会打开 查找工具窗口，显示找到的用法，您可以在其中检查结果并确认重构(执行重构)。

   元素的所有出现位置都将被重命名。

   

下次您调用 重命名 重构时，DataSpell 会记住您在 重命名 对话框中指定的选项。

提取和引入

1. 选择要重构的代码元素。 转到 代码 | 重构此...。

2. 在 重构此 弹出窗口中，选择目标重构，例如 引入变量...

   

   。

3. DataSpell 为您提供可能的变量名称列表。 您可以选择一个或输入您选择的名称。

   

重新格式化文件中的代码片段

1. 在编辑器中选择您要重新格式化的代码片段。

2. 请前往 代码 | 格式化 | 重新格式化代码 或按 Ctrl+Alt+L。 IDE 会通知您重新格式化的结果。

   

   如果您没有选择代码片段，DataSpell将重新格式化整个文件。

重新格式化文件

1. 您可以在编辑器中打开文件并按 Ctrl+Alt+Shift+L ，或者在 工作区 工具窗口中右键点击该文件并选择 重新设置代码格式。

   持续按住 Shift 并选择额外的文件进行分组格式化。

2. 在打开的 对话框中，如果需要，选择以下重新格式化选项：

   • 优化import(O) ：如果您希望删除未使用的导入、添加缺失的导入或整理导入语句，请选择此选项。

   • 重新排序条目(R) ：选择此选项以根据 代码样式设置中指定的排列规则重新排列代码。

   • 仅 VSC 更改的文本 ：选择此选项仅重新排列在版本控制系统中已修改的片段。

   • 清理代码(C) ：选择此选项以运行代码清理检查。

   如果您想查看代码在重新格式化期间所做的确切更改，请使用 本地历史记录 功能。