代码编辑

本章中介绍了 ZStudio 中代码编辑器的诸多功能点，帮助用户高效地进行代码选择、复制、移动、查找、替换等等编辑操作。

多光标及多选操作

在 ZStudio 编辑器中复制、粘贴或编辑的代码时，可以在文本中插入多个光标从而实现同时操作多行文本。

可以使用 Ctrl+Alt+Up 或 Ctrl+Alt+Down 快捷键在邻近的上一行或者下一行增加光标选中连续的范围。

也可以按住 Alt 键同时使用鼠标在不相邻的任意行点击并插入光标。

扩大或缩小选中框范围

使用快捷键 Shift+Alt+Right 可以基于当前光标所在处快速扩大选中范围；相反，Shift+Alt+Left 可以快速缩小选中范围。

选中文本列

按住快捷键 Shift+Alt，将鼠标从当前位置拖拽直至覆盖想要选中的文本区域即可实现选中一列。用快捷键 Ctrl +Alt+Shift (Linux 系统为 Alt+Shift) 结合上、下、左、右方向键可以实现同样的操作。

选中相同匹配项

如果用户希望找到与当前选中文本相同的匹配项，可以执行以下操作：

• 将光标放在目标文本出现的某个位置，连续使用快捷键 Ctrl+D 将跳转到文本匹配项下一次出现处。
• 使用快捷键 Ctrl+Shift+L 可以一次性选中匹配项在文件中出现的所有位置。

迷你地图

位于编辑区右侧的小地图可以帮助用户进行快速导航，用户可以单击或拖动阴影区域以快速定位到源代码文件的不同部分。 点击菜单栏的"视图" > "外观" > "切换到迷你地图"可关闭此功能，用户可根据勾选提示判断当前是打开或关闭状态。

搜索

ZStudio 可以帮助用户在当前打开的解决方案或文件中进行快速查找和替换。

在文件中查找替换

在代码编辑器中使用快捷键 Ctrl+F 调出搜索替换框并查找任意文本，编辑器将高亮搜索结果，并且将在迷你地图和编辑器滚动条中标记出来。配合复制快捷键一起使用 Ctrl+C > Ctrl+F 可以直接搜索当前选中并复制的文本。

点击搜索栏中的上下箭头或者使用 Enter 快捷键查找下一个匹配项；使用 Shift+Enter 快捷键查找上一个匹配项。

在选中的文本中查找

ZStudio 默认将在当前编辑器中的整个文件中执行查找操作，但是也可以选中只在某段选中的文本中执行此操作以减小搜索范围。查找框中 按钮即可控制在选中的文本中查找或是在全文中进行查找。

高级查找替换选项

查找框支持以下高级搜索选项：

• 区分大小写
• 匹配整个单词
• 正则表达式

其中，正则表达式可以使用通配符模式语法，例如：

• * 匹配路径段中的零个或多个字符
• ? 匹配路径段中的一个字符
• ** 匹配任意数量的路径段，包括无路径段
• {} 分组条件（例如 {**/* .html, **/*.txt} 匹配当前目录及其子目录中所有的 HTML 和文本文件）
• [] 声明要匹配的字符范围（例如 example.[0-9] 匹配 example.0、example.1 等）
• [!...] 否定要匹配的字符范围（例如 example.[!0-9] 匹配 example.a、example.b，但不匹配 example.0）

替换输入框支持保留大小写，可以通过点击保留大小写（AB）按钮来启用。

在搜索框中使用快捷键 Ctrl+Enter 换行，可以实现同时搜索多行文本。

当用户搜索长文本时，搜索框的默认尺寸可能无法显示全部搜索内容。用户可以拖拽左侧边栏调整搜索栏的长度，也可以双击切换最大尺寸或恢复默认尺寸。

跨文件搜索

ZStudio 支持在当前打开的解决方案的所有文件中执行快速搜索。打开"搜索"视图并输入搜索内容。搜索结果按包含搜索词的文件分组，并显示每个文件中的所有匹配项及其位置。展开文件以查看该文件中所有匹配项的预览。单击某个匹配项即可在编辑器中查看。

跨文件查找和替换

ZStudio 也支持跨文件查找和替换。打开"搜索"视图并输入需要查找和替换的内容。

在替换文本框中输入文本后，将看到待更改的差异显示。可以通过替换文本框跨所有文件进行替换，也可以在单个文件中进行替换，或替换单个更改。

格式化

ZStudio 内置 clangd 和 vscode.cpp 插件用于支持 C 和 C++ 语言的智能提示，帮助用户快速格式化源代码。

格式化整个文档：

• 在 Windows 上使用快捷键 Shift+Alt+F。
• 在 Linux 上使用快捷键 Ctrl+Shift+I。

要格式化选中的文本：

• 在 Windows 和 Linux 上使用快捷键 Ctrl+K > Ctrl+F。

除了手动调用代码格式化，也可以在设置中设定根据用户操作（如输入、保存或粘贴）自动触发格式化。

保存与恢复

所有修改都可以使用快捷键 Ctrl+S 随时手动保存，也可以通过单击 文件 > 自动保存 来开启或关闭自动保存，并通过 标记判断当前是否开启。

此外，可以在设置中配置每次保存修改文件时触发的动作。

• afterDelay：修改内容将在设定的毫秒延迟后自动保存。
• onFocusChange：修改内容将在失去焦点时自动保存。
• onWindowChange：修改内容将在窗口失去焦点时自动保存。

恢复更改

对于最近的更改，可以使用快捷键 Ctrl+Z 进行撤销，或选择 "文件" > "保存全部"。要更全面地跟踪所有更改，请使用版本管理功能。

折叠或展开代码

通过点击行号和行首之间的折叠图标，可以折叠或展开代码块，隐藏不需要显示的代码，保持屏幕简洁清晰。除了折叠图标上移动鼠标并点击以实现代码折叠或展开外，可以使用以下快捷键快速折叠：

• 折叠 Ctrl+Shift+[ 折叠光标处未折叠的最内层区域。
• 展开 Ctrl+Shift+] 展开光标处的已折叠区域。
• 切换折叠 Ctrl+K > Ctrl+L 折叠或展开光标处的区域。
• 递归折叠 Ctrl+K > Ctrl+[ 折叠光标处未折叠的最内层区域及其内的所有区域。
• 递归展开 Ctrl+K > Ctrl+] 展开光标处的区域及其内的所有区域。
• 折叠全部 Ctrl+K > Ctrl+0 折叠编辑器中的所有区域。
• 展开全部 Ctrl+K > Ctrl+J 展开编辑器中的所有区域。
• 折叠级别 X (Ctrl+K > Ctrl+2 为级别 2) 折叠级别 X 的所有区域，除了当前光标位置的区域。

-折叠所有块注释 Ctrl+K > Ctrl+/ 折叠所有以块注释符号开头的区域。

备注

单击左下角的齿轮按钮并选择键盘快捷键查看所有可用的快捷键。

智能提示

智能提示（IntelliSense）包括各种代码导航和代码编辑功能，例如代码补全、悬浮参数信息, 错误及快速修复，查看定义以及代码重构等。 ZStudio 内置 clangd 和 vscode.cpp 插件用于支持 C 和 C++ 语言的智能提示，帮助用户快速编码，提高开发效率。

代码导航

用户可以通过多种不同的操作在编辑器中快速定位代码。

快速文件导航

当用户在查看代码时，如果要跟踪代码中包含的链接，或者找到已定义代码元素的文件，可以按住 Ctrl 并点击链接或代码元素。文件将在新编辑器中打开，显示链接内容或代码定义所在的位置。

大纲

大纲视图以目录树的形式给用户提供当前文件中的函数，变量，类等代码结构。 在右侧活动栏点击 按钮可以快速展开大纲视图。点击大纲视图中的元素可以在文件中进行快速导航。当文件中的元素过多时，用户也可以在大纲视图中输入字符搜索指定元素。

转到符号

通过精准搜索可以让用户迅速定位至符号，在编辑器空白区域右键并选择"转到符号..."，弹出的下拉框将显示当前文件中所有可跳转的符号，选择并点击跳转到指定符号位置。

寻找定义和引用

"转到定义"和"速览定义"功能有助于用户快速查看并找到源代码元素的定义。将鼠标悬浮在代码元素上，右键并选择：

• "转到定义"：快速跳转至当前文件中定义元素的位置；如果定义位于其他文件，则会在新的编辑器窗口中打开文件。
• "快速查看" > "速览定义"： 在当前位置打开元素定义的预览窗口。

用户也可以通过"转到引用"和"查看引用"在同一个解决方案内查看某个代码元素的所有引用。这两个选项在当前位置显示文件元素所有引用的预览；当前元素只有一个引用时，"转到引用"选项将会直接跳转到引用位置。用户可以在预览窗口中快速导航，并进行编辑修改。

代码补全

根据用户在编辑区内键入的字符，IntelliSense 将进行源代码分析，弹出输入建议，用户可在选单中进行 快速选择并按 Tab 或 Enter 插入选定的输入建议。

错误提示和快速修复

当 ZStudio 检测到代码中存在需要处理的编译器错误或警告，将会用红色波形曲在原位置标识出来。 所有的错误信息将会在问题（Problems） 视图中列出。点击状态栏的 快捷按钮或者从"视图" 下拉菜单中选择"问题（Problems）"打开面板。

ZStudio 提供了常见问题的快速修复建议，例如遗漏分号，并且帮用户完成自动修正。

1. 将鼠标悬浮于红色波形曲线标出的代码部分。
2. 点击错误提示旁出现的灯泡形状图标。
3. 查看给出的建议并决定是否采用快速修正。

代码重构

ZStudio 支持简单的代码重构，例如提取变量，提取函数，或者对符号进行重命名。当用户用鼠标选取部分代码段，并点击随之出现的灯泡形状图标，将会出现相关重构操作。用户也可以选择需要提取的代码并在右键上下文菜单中选择"重构..."

如果用户向对代码中的某个元素进行重命名，例如函数，类，或者变量，可以使用"重命名符号"操作。 它可以帮助你在文件中批量更改某个符号的名称。

并排编辑

用户可以通过以下操作将多个源代码文件同时放进编辑区实现上下左右分区查看或并排编辑：

• 使用 Ctrl+\ 快捷键在编辑区中已有文件的右侧新建分区。

• 点击工具栏的 （向右拆分编辑器）快捷按钮。

• 从文件导航（File Navigator）面板中右键点击源代码文件，选择文件在编辑区中打开的位置。

• 右键选项卡选择文件在编辑区中打开的位置。

• 用鼠标将文件拖放到编辑区域的任意一侧。

  

当用户打开多个编辑区的时候，可以拖放编辑区文件标题以重新定位或调整编辑区大小。