华为云用户手册

设置优先级 配置可以在多个级别上被不同的设置范围覆盖。在以下列表中，较晚的作用域覆盖较早的作用域： Default settings：此范围表示默认未配置的设置值。 User settings：全局应用于所有CodeArts IDE实例。 Workspace settings：应用于打开的文件夹或工作区。 Language-specific default settings：这些是特定于语言的默认值，可由扩展提供。 Language-specific user settings：特定于语言的用户设置：与用户设置相同，但特定于语言。 Language-specific workspace settings：与工作区设置相同，但特定于语言。 设置值可以是多种类型： String："files.autoSave"："afterDelay" Boolean："editor.minimap.enabled"：true Number："files.autoSaveDelay"：1000 Array："editor.rulers"：[] Object："search.exclude"：{ "**/node_modules"： true, "**/bower_components"： true } 具有基元类型和数组类型的值将被覆盖，这意味着使用作用域中优先于另一个作用域的配置值，而不是另一个作用域中的值。但是，具有对象类型的值将合并。 例如，workbench.colorCustomizations采用一个对象，该对象指定一组UI元素及其所需颜色。如果您的用户设置将编辑器背景设置为蓝色和绿色。 "workbench.colorCustomizations": { "editor.background": "#000088", "editor.selectionBackground": "#008800" } 打开的工作区设置将编辑器前景设置为红色： "workbench.colorCustomizations": { "editor.foreground": "#880000", "editor.selectionBackground": "#00FF00" } 当该工作区打开时，结果是这两种颜色自定义的组合，就像您指定了： "workbench.colorCustomizations": { "editor.background": "#000088", "editor.selectionBackground": "#00FF00", "editor.foreground": "#880000" } 如果存在冲突的值，如上面示例中的editor.selectionBackground，则会发生通常的覆盖行为，工作区值优先于用户值，语言特定的值优先于非语言特定的值。 父主题： 配置CodeArts IDE基础属性

设置筛选器 “设置”编辑器的搜索栏提供了几个筛选器，使用户更容易管理设置。使用搜索栏中的“筛选器”按钮（）轻松添加筛选器。 要检查用户配置的设置，请使用@modified的筛选器。如果设置的值与默认值不同，或者其值在相应的设置JSON文件中显式设置，则会显示在此筛选器下。 还有几个其他方便的过滤器可以帮助搜索设置： @ext：特定于扩展的设置。提供扩展ID，例如，@ext:markdown-language-features。 @feature：特定于功能子组的设置。例如，@feature:explorer显示资源管理器的设置。 @id：根据设置ID查找设置。例如，@id:workbench.activityBar.visible。 @lang：根据语言ID应用语言筛选器。例如，@lang:typescript。 @tag：特定于CodeArts IDE子系统的设置。 搜索栏会记住用户的设置搜索查询，并支持撤销/重做（“Ctrl+Z”/“Ctrl+Shift+Z”/“Ctrl+Y”）。用户可以使用搜索栏右侧的“清除设置搜索输入”按钮（）快速清除搜索项或筛选器。

通过URLs打开项目和文件 您还可以使用操作系统的URL处理机制打开项目和文件。 使用以下URL格式： 打开项目 codearts://file/{full path to project}/ codearts://file/c:/myProject/ 打开文件 codearts://file/{full path to file} codearts://file/c:/myProject/package.json 在特定行和列上打开文件 codearts://file/{full path to file}:line:column codearts://file/c:/myProject/package.json:5:10 您可以在浏览器或文件资源管理器等应用程序中使用URL，这些应用程序可以解析和重定向URL。例如，您可以将codearts://URL直接传递给Windows资源管理器，或作为codearts://{full path to file}传递给命令行。 父主题： 使用命令行操作CodeArts IDE

通过CodeArts CLI打开文件 您可以通过CodeArts CLI打开或创建文件。如果指定的文件不存在，CodeArts IDE将创建该文件以及任何新的中间文件夹： codearts index.html style.css documentation\readme.md 对于文件和文件夹，您可以使用绝对路径或相对路径。相对路径是相对于运行codearts命令的命令提示符的当前目录。 如果在命令行中指定多个文件，CodeArts IDE将仅打开一个实例。 如果在命令行中指定多个文件夹，CodeArts IDE将创建一个包括每个文件夹的多根工作区。 参数 描述 file 要打开的文件的名称。如果文件不存在，则将创建并标记为已编辑。您可以通过用空格分隔每个文件名来指定多个文件。 file:line[:character] 与-g参数一起使用。要在指定行和可选字符位置打开的文件的名称。您可以以这种方式指定多个文件，但在使用file:line[：character]说明符之前，必须使用-g参数（一次）。 folder 要打开的文件夹的名称。您可以指定多个文件夹，并创建新的多根工作区。 父主题： 使用命令行操作CodeArts IDE

运行选定的文本 要通过终端执行某些文本，如脚本的一部分，请在编辑器中选中它，然后通过“命令”面板（按“Ctrl+Shift+P”或“双击Ctrl”）运行命令“终端: 在活动终端运行所选文本”： 终端尝试运行选定的文本。 如果在活动编辑器中没有选择文本，则光标下的行将在终端中运行。您也可以通过workbench.action.terminal.runActiveFile命令运行活动文件。 父主题： 使用集成终端运行命令

在终端中查找文本 集成终端具有查找功能，可使用Ctrl+F触发。 如果您希望“Ctrl+F”转到shell而不是启动Find控件，请将以下内容添加到settings.json中，这将告诉终端不要跳过与workbench.action.terminal.focusFind命令匹配的键绑定。焦点查找命令匹配的键绑定的shell： { "terminal.integrated.commandsToSkipShell": [ "-workbench.action.terminal.focusFind" ], } 有关在CodeArts IDE中搜索文本的详细信息，请参见通过代码搜索方式。 父主题： 使用集成终端运行命令

终端中的同时按下键绑定 默认情况下，当同时按下键绑定是最高优先级时，它将始终跳过终端shell（绕过terminal.integrated.commandsToSkipShell）转到CodeArts IDE。这通常是想要的行为，除非您希望shell使用“Ctrl+K”（对于bash，这将剪切光标之后的行）。这可以通过terminal.integrated.allowChords设置禁用： { "terminal.integrated.allowChords": false }

终端配置文件 终端配置文件是特定于平台的终端配置，由可执行路径、参数和其他自定义项组成。 配置文件示例如下： { "terminal.integrated.profiles.windows": { "My PowerShell": { "path": "pwsh.exe", "args": [ "-noexit", "-file", "${env:APPDATA}\PowerShell\my-init-script.ps1" ] } }, "terminal.integrated.defaultProfile.windows": "My PowerShell" } 用户可以在终端配置文件中使用变量（例如上面示例中的APPDATA环境变量），也可以通过运行“终端: 选择默认配置文件”命令选择默认的集成终端。 要从“启动配置文件...”列表（）中删除条目，请将配置文件的名称设置为null。 例如，要删除Git Bash配置文件，请在settings.json文件（所在路径为“%AppData%\codearts-java\User\settings.json”或“%AppData%\codearts-cpp\User\settings.json”）使用以下设置。 { "terminal.integrated.profiles.windows": { "Git Bash": null } } 父主题： 使用集成终端运行命令

终端实例分组 “终端”提供了多种功能，让用户可以自定义其布局。 要将当前终端实例拆分为两个，从而创建组，请执行以下任一操作： 在选项卡列表中，悬停选项卡，然后单击“拆分”按钮（）。 在选项卡列表中，选中选项卡，按“Ctrl+Shift+5”。 要将终端实例添加到组，请将对应选项卡拖入当前显示终端区域。要重新排列组中的选项卡，可以拖拽选项卡调整其在组内的顺序。 要取消拆分终端，请在选项卡列表中右键单击该终端，然后从上下文菜单中选择“取消拆分终端”。 要在终端组内导航，请使用以下键盘快捷键。 按“Ctrl+Pagedown”或“Alt+→”键聚焦下一组。 按“Ctrl+Pageup”或“Alt+←”键聚焦上一组。 在组中，通过使用“Alt+↑”聚焦上一个窗格，使用“Alt+↓”聚焦下一个窗格，在终端之间导航。

终端进程重连 本地和远程终端进程在窗口重新加载时恢复（例如，当扩展安装需要重新加载时）。终端将重新连接，终端的UI状态将恢复，包括活动选项卡和拆分终端相对尺寸。 实验设置terminal.integrated.persistentSessionReviveProcess允许您定义在终端进程关闭后（例如，在窗口或应用程序关闭时）应恢复以前的终端会话内容并重新创建进程的时间。恢复进程的当前工作目录取决于shell是否支持它。

工作目录 默认情况下，终端在资源管理器中当前打开的文件夹中打开。使用terminal.integrated.cwd设置，您可以指定要打开的自定义路径。 在Windows上，反斜杠符号\必须转义为\\。请注意， { "terminal.integrated.cwd": "D:\\CodeArtsProjects" } 拆分终端从父终端启动的目录中启动。可以使用terminal.integrated.splitCwd设置更改此行为，以便拆分终端在当前工作区根中启动。 { "terminal.integrated.splitCwd": "workspaceRoot" }

变基 Rebase命令允许您将源分支的提交应用到目标分支的HEAD提交之上。 切换到源分支，即您想要将其提交应用到另一个分支上的分支。有关详细信息，请参阅切换分支。 在Source Control视图中，展开Source Control Repositories部分。 单击要将一个分支的更改合并到另一个分支中的存储库旁边的More Actions按钮（），指向Branch，然后选择Rebase Branch。 在打开的弹出窗口中，选择您要将更改应用到的目标分支。

解决合并的冲突 在某些情况下，您在本地对文件所做的更改可能与其他人对同一文件所做的更改冲突。另一个常见的原因是将一个分支合并到另一个分支。CodeArts IDE会识别这种合并冲突并显示相应的通知。 解决合并冲突的步骤如下： 在源代码控制视图的合并更改部分，找到包含冲突更改的文件。 双击该文件，在代码编辑器中打开它，进入专门的冲突视图。使用内联的CodeLens来处理合并冲突：您可以接受当前更改、传入的更改，或者两个更改都接受。 要通过差异查看器详细查看更改，请单击Compare Changes。 一旦冲突解决完毕，您可以将冲突的文件暂存并提交更改。

合并 Merge命令允许您将源分支的更改集成到目标分支的HEAD中。Git会创建一个新的提交（称为“合并提交”），将源分支和目标分支从两个分支分叉点开始的更改合并在一起。 切换到目标分支，即您想要将更改合并到的分支。有关详细信息，请参阅切换分支。 在Source Control视图中，展开Source Control Repositories部分。 单击要将一个分支的更改合并到另一个分支的存储库旁边的More Actions按钮（），指向Branch，然后选择Merge Branch。 在打开的弹出窗口中，选择要从中合并更改的分支。如果发生合并冲突，请按照解决合并冲突中描述的方法解决它。

切换分支 执行以下操作之一： 在Source Control视图中，展开Source Control Repositories部分，单击要切换到另一个分支的存储库旁边的More Actions按钮（），然后选择Checkout to。 在CodeArts IDE状态栏中单击分支名称。 在打开的弹出窗口中，选择要切换到的分支，然后按Enter键。如果选择了一个尚不存在本地分支的远程分支，则CodeArts IDE将自动创建本地分支。 您还可以通过Checkout to弹出窗口创建新的本地分支。

创建分支 在Source Control视图中，展开Source Control Repositories部分。 单击要在其中创建新分支的存储库旁边的More Actions按钮（），指向Branch，然后执行以下操作之一： 要从当前正在工作的分支创建新分支，请选择Create Branch，并在打开的弹出窗口中提供新分支的名称，然后按“Enter”键。 要从存储库中的其他分支创建新分支，请选择Create branch from，并在打开的弹出窗口中选择源分支。 然后在打开的弹出窗口中提供新分支的名称，然后按“Enter”键。 CodeArts IDE会自动创建一个新分支并切换到该分支。如果Git存储库已设置远程，可以在Source Control Repositories部分或CodeArts IDE状态栏中单击Publish按钮（）将当前分支发布到远程。

Stash存储 使用stash存储，可以将当前更改移动到临时位置，而无需将其提交，从而将工作副本恢复到“干净”（即HEAD提交）状态。 要存储更改，请执行以下操作： 在“源代码管理”视图中，展开“源代码管理”部分。 单击要存储更改的存储库旁边的“更多操作”按钮（），指向“储藏”，然后执行以下操作之一： 要存储已暂存的更改，请选择“储藏”。 要存储所有更改，包括未暂存和未版本化的文件，请选择“储藏（包含未跟踪）”。 移动更改后，用户可以随时重新应用它们到用户的工作副本中。 在“源代码管理”视图中，展开“源代码管理”部分。 单击要重新应用更改的存储库旁边的“更多操作”按钮（），指向“储藏”，然后执行以下操作之一： 要应用最近的存储，请选择“应用最新储藏”。如果用户还想从存储堆栈中删除已应用的存储，请选择“应用最新储藏”。 要应用任意存储，请选择“应用储藏”，然后在打开的弹出窗口中选择所需的存储。如果用户还想从存储堆栈中删除已应用的存储，请选择“弹出储藏”。 用户可以清理存储堆栈以删除不再需要的存储。 在“源代码管理”视图中，展开“源代码管理”部分。 单击要重新应用更改的存储库旁边的“更多操作”按钮（），指向“储藏”，然后执行以下操作之一： 要删除任意存储，请选择“删除储藏”，并在打开的弹出窗口中选择所需的存储。 要删除所有存储，请选择“删除所有储藏”。 父主题： 管理版本控制下的文件

提交 当您对代码进行一些更改时，您需要将它们提交到本地项目存储库，然后将它们推送到远程存储库，以便团队成员可以使用。 在提交之前，请确保您的Git配置中设置了用户名和/或电子邮件。否则，Git将使用本地计算机上的信息。您可以在Git提交信息中找到详细信息。 通过将更改添加到暂存区来准备提交。要执行此操作，请在源代码控制视图的更改部分中执行以下操作之一。 要暂存整个文件，请单击“暂存更改”按钮（），或右键单击文件并选择“暂存更改”。 要暂存文件的一部分，请双击文件以打开差异视图，该视图提供更改的概述。选择要暂存的更改，右键单击并选择“暂存所选范围”，或先按下“Ctrl+K”再按下“Ctrl+Alt+S”快捷键触发。 在“源代码管理”视图中，在字段中输入提交消息，然后单击“提交”按钮或按“Ctrl+Enter”。 要撤销提交，请单击“更多操作”按钮（）并选择“撤销上次提交”。更改将重新添加到“暂存的更改”部分。 父主题： 管理版本控制下的文件

管理版本简介 当用户的项目与源代码管理（SCM）系统关联时，CodeArts IDE会跟踪项目文件中发生的所有更改。左侧活动栏中的“源代码管理”按钮（）显示用户当前在存储库中拥有的更改数量。 “源代码管理”视图显示当前存储库更改的详细信息，分为“更改”、“暂存的更改”和“合并更改”三个组。 单击每个项目将详细显示每个文件中的文本更改。请注意，对于未暂存的更改，右侧的编辑器仍然允许用户编辑文件。 CodeArts IDE提供了存储库状态的指示：当前分支、脏状态指示以及当前分支中传入和传出提交的数量。用户可以在“源代码管理”部分的存储库记录旁边或CodeArts IDE状态栏中查看它们。 父主题： 管理版本控制下的文件

复制和移动文件和文件夹 您可以在同一主机上以及不同主机上的位置之间复制和移动文件和文件夹。 在“远程文件管理器”区域中，右键单击要复制或要移动到其他位置的文件/文件夹。 要复制文件/文件夹，请在上下文菜单中选择“复制”，或按Ctrl+C。 要移动文件/文件夹，请在上下文菜单中选择“剪切”，或按Ctrl+X。 右键单击要将文件/文件夹移动到的文件夹，然后在上下文菜单中选择“粘贴”，或按Ctrl+V。 父主题： 配置RemoteShell连接文件系统

用户界面概述 RemoteShell的用户界面由以下主要部分组成： “云资源”区域，列出与您的华为云账户关联的所有云资源：弹性云服务器（E CS ）、云容器引擎（CCE）。 “远程文件管理器”区域，提供对已连接主机的文件系统的访问。 “编辑器”区域，该区域保存当前打开的远程终端会话和文件的选项卡。 “会话管理”区域，用于管理主机和连接。 “通知”区域，列出了RemoteShell中最近发生的通知和事件。

启动配置示例 您可以使用提供的示例作为远程调试场景的示例。 主机应用程序的启动配置是一个常规的Java类配置。它应该包含在vmOptions下提供的特殊参数，以便应用程序使用调试代理启动，并且调试器能够连接到它。 { "type": "javadbg", "name": "Java Class", "request": "launch", "vmOptions": "-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=127.0.0.1:5005", "mainClass": { "name": "com.example.App", "console": "internal" } } 远程调试的启动配置应该使用提供给主机应用程序启动配置的连接参数。 { "type": "javadbg", "name": "Remote Debug (Attach to remote JVM)", "request": "launch", "skipBuild": true, "remote": { "debuggerMode": "attach", "useSocketTransport": true, "host": "127.0.0.1", "port": "5005" } }

启动配置属性 名称 描述 type 描述 type 调试器的类型。对于运行和调试Java代码，应将其设置为javadbg。 name 启动配置名称。 env 额外的环境变量 skipBuild 跳过程序的构建过程（设置为true）或不跳过（设置为false）。 temporary 指示启动配置是否为临时的（设置为true）还是永久的（设置为false）。如果临时启动配置数量超过指定限制，CodeArts IDE会自动删除最不常用的配置。有关详细信息，请参阅启动配置。 killPrevSession 终止具有相同名称的先前运行会话（设置为true），或中止启动（设置为false）。 debuggerMode 调试器模式，可以设置为attach（连接到远程JVM）或listen（监听传入连接）。默认情况下，使用attach模式。 autoRestart 仅在debuggerMode设置为listen时可用，定义调试器在远程JVM断开连接后是否自动重启。默认情况下，使用false。 useSocketTransport 定义是否使用套接字传输来连接进程。默认情况下，使用true。否则，当设置为false时，使用共享内存。 host 主机应用程序运行的机器的地址。默认情况下，使用127.0.0.1。 port 目标机器上的连接端口。默认情况下，使用5005。

启动配置示例 您可以使用提供的示例作为工作启动配置的示例。 运行来自package.name包的所有测试： { "type": "javadbg", "name": "TestNG Test (Package)", "request": "launch", "testNG": { "package": "package.name" }, "vmOptions": "-ea" } 运行单个测试方法qualified.method.name： { "type": "javadbg", "name": "TestNG Test (Method)", "request": "launch", "testNG": { "method": "qualified.method.name" }, "vmOptions": "-ea" }

启动配置属性 在启动配置中，您只能指定以下属性之一：方法（method）、类（class）、包（package）或目录（directory），以运行单个测试方法、单个测试类、包中的所有测试或目录中的所有测试。 名称 描述 type 描述 type 调试器的类型。对于运行和调试Java代码，应将其设置为javadbg。 name 启动配置名称。 env 额外的环境变量 skipBuild 跳过程序的构建过程（设置为true）或不跳过（设置为false）。 temporary 指示启动配置是否为临时的（设置为true）还是永久的（设置为false）。如果临时启动配置数量超过指定限制，CodeArts IDE会自动删除最不常用的配置。有关详细信息，请参阅启动配置。 killPrevSession 终止具有相同名称的先前运行会话（设置为true），或中止启动（设置为false）。 vmOptions JVM的额外选项。 method 完全限定的测试方法名称。 class 完全限定的测试类名称。 package 测试包名称。 directory 包含测试源代码的目录。默认情况下，此项设置为${workspaceRoot}/src/test。您可以使用变量来提供路径。

启动配置属性 在启动配置中，您只能指定以下属性之一：方法（method）、类（class）、包（package）或目录（directory），以运行单个测试方法、单个测试类、包中的所有测试或目录中的所有测试。 名称 描述 type 描述 type 调试器的类型。对于运行和调试Java代码，应将其设置为javadbg。 name 启动配置名称。 env 额外的环境变量 skipBuild 跳过程序的构建过程（设置为true）或不跳过（设置为false）。 temporary 指示启动配置是否为临时的（设置为true）还是永久的（设置为false）。如果临时启动配置数量超过指定限制，CodeArts IDE会自动删除最不常用的配置。有关详细信息，请参阅启动配置。 killPrevSession 终止具有相同名称的先前运行会话（设置为true），或中止启动（设置为false）。 vmOptions JVM的额外选项。 method 完全限定的测试方法名称。 class 完全限定的测试类名称。 package 测试包名称。 directory 包含测试源代码的目录。默认情况下，此项设置为${workspaceRoot}/src/test。您可以使用变量来提供路径。

启动配置示例 您可以使用提供的示例作为工作启动配置的示例。 运行来自package.name包的所有测试： { "type": "javadbg", "name": "JUnit Test (Package)", "request": "launch", "jUnit": { "package": "package.name" }, "vmOptions": "-ea" } 运行单个测试方法qualified.method.name： { "type": "javadbg", "name": "JUnit Test (Method)", "request": "launch", "jUnit": { "method": "qualified.method.name" }, "vmOptions": "-ea" }

启动配置属性 名称 描述 type 描述type调试器的类型。对于运行和调试Java代码，应将其设置为javadbg。 name 启动配置名称。 env 额外的环境变量 skipBuild 跳过程序的构建过程（设置为true）或不跳过（设置为false）。 temporary 指示启动配置是否为临时的（设置为true）还是永久的（设置为false）。如果临时启动配置数量超过指定限制，CodeArts IDE会自动删除最不常用的配置。有关详细信息，请参阅启动配置。 killPrevSession 终止具有相同名称的先前运行会话（设置为true），或中止启动（设置为false）。 vmOptions JVM的额外选项。 goals Maven的目标是运行。可以将目标名称作为单个字符串或字符串数组提供。

启动配置属性 名称 描述 type 描述type调试器的类型。对于运行和调试Java代码，应将其设置为javadbg。 name 启动配置名称。 env 额外的环境变量 skipBuild 跳过程序的构建过程（设置为true）或不跳过（设置为false）。 temporary 指示启动配置是否为临时的（设置为true）还是永久的（设置为false）。如果临时启动配置数量超过指定限制，CodeArts IDE会自动删除最不常用的配置。有关详细信息，请参阅启动配置。 killPrevSession 终止具有相同名称的先前运行会话（设置为true），或中止启动（设置为false）。 vmOptions JVM的额外选项。 scriptArgs 传递给Gradle的参数的数组。 tasks 要运行的Gradle任务。提供一个对象数组，每个对象都有一个名称（任务名称）和一个可选的args数组，其中包含任务的参数。

启动配置示例 您可以将提供的示例作为一个可行的启动配置示例。 { "type": "javadbg", "name": "Gradle", "request": "launch", "skipBuild": true, "gradle": { "scriptArgs": [ "--info" ], "tasks": [ "build" ] } }