用户界面

首次进入嵌入式应用开发模式欢迎页面，最近列表将为空。之后每次在登录状态下启动，ZStudio 都会以上次关闭时的状态打开并保留所有窗口。

基础布局

ZStudio 的用户界面由各种轻量级的模块化小部件（widgets）组成，其最大特点是非常灵活，当用户在 ZStudio 中打开项目时，用户界面如图所示：

菜单栏（Menu Bar)：位于最上方，为用户提供各项功能入口，点击即可显示出菜单选项。

工具栏（Toolbar）：位于菜单栏下方，用户可以根据偏好更改工具栏的默认布局，详见自定义工具栏小节。

活动栏（Activity Bar）：位于页面对称的最左侧和最右侧。活动栏具有提示的功能，例如用 Git 进行版本控制时，活动栏的 Git 图标（icon）会提示源代码挂起的更改数量。

侧边面板（Side Panel）：与活动栏相邻，显示当前活动栏的视图，大多数视图默认显示在左侧，如解决方案资源管器（Solution Explorer）。视图中的交互按钮可帮助用户快捷处理项目。

编辑区（Editor）：编辑源代码文件的主要区域，用户可以垂直或水平并排打开任意数量的编辑器，编辑区在显示视图的上方有一个导航栏（Breadcrumbs）用于显示文件路径，方便用户在路径之间快速切换。

底部面板（Bottom Panel）：位于编辑器区域下方，用户可以在底部面板栏调出终端，查看错误、警告，输出或调试信息等。

状态栏（Status Bar）：位于最下方，显示有关当前项目信息和通知等。

调整布局

ZStudio 由各种轻量级的模块化小部件组成，例如编辑器和视图等，所有视图都可以通过拖动到的方式停靠在用户指定的布局上。 显示在编辑区（Editor）和底部面板（Bottom Panel）的视图通过选项卡（Tabs）进行控制，用户可以拖动选标题选项卡改变内容停靠的位置，点击选项卡上的 × 将其关闭。

显示在侧边面板（Side Panel）的视图通过与其相邻的活动栏（Activity Bar）视图图标进行控制，点击左下角的"首选项" > "文件图标主题"显示 ZStudio 内所有文件的图标。 用户可以拖动视图图标改变视图停靠的位置或移除该视图（右点击图标选择"关闭"将其隐藏），对布局内的视图进行重新排序以便操作方便，或者将视图并排放置以进行比较。

如需重新打开隐藏的视图，可通过命令面板"视图"选单选择相应的活动项；切换视图可见性，在视图选单中会有相应的勾选状态提示。 在命令面板中，搜索并选择查看：重置工作台面布局可还原所有默认布局。

自定义工具栏

ZStudio 支持在工具栏（toolbar）添加命令的快捷方式，用户可以通过菜单栏选择"视图"

"切换工具栏"或使用快捷键 Alt+T 开启或关闭工具栏默认显示。

工具栏的默认快捷按钮从左至右依次为撤回操作，取消撤回，拆分编辑区以及打开命令面板。用户可以将常用的命令设置为新按钮添加至工具栏，具体操作如下：

1. 右键点击工具栏，选择"将命令添加到工具栏"。

2. 首先在选单中选择想添加的命令，点击后跳转到为命令设置图标的弹窗。

3. 为命令添加合适的图标，点击"选择图标"。

4. 在弹出的选择列表中选择图标将要放置的位置。

   

用户可以通过拖拽命令图标来调整其在工具栏中的位置，选择左对齐，居中，或右对齐放置； 右键工具栏上的图标选择"从工具栏上删除命令"可移除该命令图标；如需恢复工具栏默认样式， 右键选择"恢复工具栏默认值"，此操作会一并删除用户添加的所有自定义命令图标。

并排编辑

用户可以将多个源代码文件同时放进编辑区进行上下左右分区查看或编辑，如果你已经打开了一个 编辑器，可以通过以下操作实现并排编辑：

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

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

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

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

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

  

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

迷你地图

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

缩进指南

编辑区中的行号可帮助用户查找代码。代码中的虚线指示哪对大括号彼此匹配， 还可通过点击左侧的指示标来折叠或展开代码块，隐藏不需要显示的代码，最大程度地减少屏幕混乱。

命令面板

通过命令面板可以实现许多快捷操作。使用快捷键 Ctrl+Shift+P 可快速打开命令面板，用户可以在此处快速查找 ZStudio 的功能，以下是一些使用提示：

• 输入 ? 查看命令提示选单（Quick Pick）。

  

• 输入"命令 + 空格" 将显示选单，例如键入 view 然后按 space 可以查看所有视图，点击则打开相应视图。

  

• 用户可以在命令面板中执行编辑器命令、打开文件、搜索符号、快速定位等：

  • 快捷键 Control+P 可以帮助快速查找或打开文件

  • 快捷键 Control+Shift+O 可以帮助快速查看文件中的特定符号

  • 快捷键 Control+G 可以帮助快速定位到文件中的特定行

智能提示

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

代码导航

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

快速文件导航

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

大纲

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

转到符号

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

寻找定义和引用

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

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

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

代码补全

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

错误提示和快速修复

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

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

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

代码重构

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

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

文件对比

ZStudio 中自带的文件对比功能（diff tool），可以用于比较项目中两个文件的差异，或者比较 Git 迭代版本，当两个文件在同一个 ZStudio 窗口内即可实现文件对比及同屏滚动。

1. 在**文件导航（File Navigator）**中右键单击第一个文件，选择"选择以进行比较"。
2. 然后在**文件导航（File Navigator）**中右击第二个文件，选择"与已选项进行对比"。

或者，用户也可以按住 CTRL 键同时选择两个文件，右键单击其中一个，然后选择"互相对比"来实现相同的目的。

点击之后会在编辑区中打开差异面板，左边显示先加入对比的文件，右边显示后加入对比的文件。行号旁有符号提示，"-"代表修改前（先加入对比）的代码，"+"代表修改后（后加入对比）的代码。用户可以直接在差异面板中编辑文件，如果在其中一个文件中新增代码行，则另一个对比文件中会有网格线提示新增区域的范围。

版本差异对比

diff tool 也可以用于比较 Git 文件版本。请单击活动栏中的 Git 图标，点击想要比较的文件，ZStudio 将在编辑区中打开此文件最新 Git 版本与本地更改对比的差异面板。