DevEco Studio 编辑器的使用

it奔跑在路上2025-09-27 13:50

DevEco Studio支持使用多种语言进行应用/元服务的开发，包括ArkTS、JS和C/C++。在编写应用/元服务阶段，可以通过掌握代码编写的各种常用技巧，来提升编码效率。

代码高亮

支持对代码关键字、运算符、字符串、类、标识符、注释等进行高亮显示，您可以打开File > Settings （macOS为DevEco Studio > Preferences/Settings ）面板，在Editor > Color Scheme 自定义各字段的高亮显示颜色**。默认情况下，您可以在Language Defaults**中设置源代码中的各种高亮显示方案，该设置将对所有语言生效；如果您需要针对具体语言的源码高亮显示方案进行定制，可以在左侧边栏选择对应的语言，然后取消"Inherit values from"选项后设置对应的颜色即可。

代码跳转

在编辑器中，可以按住Ctrl 键（macOS为Command键），鼠标单击代码中引用的类、方法、参数、变量等名称，自动跳转到定义处。若单击定义处的类、变量等名称，当仅有一处引用时，可直接跳转到引用位置；若有多处引用，在弹窗中可以选择想要查看的引用位置。

跨语言跳转

DevEco Studio支持在声明或引用了Native接口的文件中（如d.ts）跨语言跳转其对应的C/C++函数，从而提升混合语言开发时的开发效率。您可以选中接口名称单击右键，在弹出的菜单中选择Go To > Implementation(s) （或使用快捷键Ctrl+Alt+B，macOS为****Command**+Option+B**）实现跨语言跳转。

代码格式化

代码格式化功能可以帮助您快速的调整和规范代码格式，提升代码的美观度和可读性。默认情况下，DevEco Studio已预置了代码格式化的规范，您也可以个性化的设置各个文件的格式化规范，设置方式如下：在File > Settings > Editor > Code Style （macOS为DevEco Studio > Preferences/Settings > Editor > Code Style）下，选择需要定制的文件类型，如ArkTS，然后自定义格式化规范即可。

在使用代码格式化功能时，您可以使用快捷键Ctrl + Alt + L （macOS为Option+Command +L） 可以快速对选定范围的代码进行格式化。

如果在进行格式化时，对于部分代码片段不需要进行自动的格式化处理，可以通过如下方式进行设置：

  1. 在File > Settings >Editor > Code Style （macOS为DevEco Studio > Preferences/Settings > Editor > Code Style），单击"Formatter"，勾选"Turn formatter on/off with markers in code comments"。

  2. 在不需要进行格式化操作的代码块前增加"//@formatter:off"，并在该代码块的最后增加"//@formatter:on"，即表示对该范围的代码块不需要进行格式化操作。

若工程已配置code-linter.json5文件，选中code-linter.json5文件右键选择Apply CodeLinter Style Rules ，代码格式化规则将与已配置的code-linter.json5文件中相关规则保持一致。code-linter.json5文件配置请参考配置代码检查规则。

代码折叠

支持对代码块的快速折叠和展开，既可以单击编辑器左侧边栏的折叠和展开按钮对代码块进行折叠和展开操作，还可以对选中的代码块单击鼠标右键选择折叠方式，包括折叠、递归折叠、全部折叠等操作。

代码快速注释

支持对选择的代码块进行快速注释，使用快捷键Ctrl+/ （macOS为Command+/ ）进行快速注释。对于已注释的代码块，再次使用快捷键Ctrl+/ （macOS为Command+/）取消注释。

代码结构树

使用快捷键Alt + 7 / Ctrl + F12 （macOS为Command+7）打开代码结构树，快速查看文件代码的结构树，包括全局变量和函数，类成员变量和方法等，并可以跳转到对应代码行。

代码引用查找

提供Find Usages代码引用查找功能，帮助开发者快速查看某个对象(变量、函数或者类等)被引用的地方，用于后续的代码重构，可以极大的提升开发者的开发效率。

使用方法：在要查找的对象上，单击鼠标右键 > Find Usages 或使用快捷键Alt +F7 （macOS为Option + F7 ）。可点击图标查看变量赋值位置，点击图标查看变量引用情况。

函数注释生成

DevEco Studio支持在函数定义处，快速生成对应的注释。在函数定义的代码块前，输入**"/**"+回车键**，快速生成注释信息。

说明

C++文件同时支持使用**"//!"+回车****键**快速生成注释。

代码查找

通过对符号、类或文件的即时导航来查找代码。检查调用或类型层次结构，轻松地搜索工程里的所有内容。通过连续点击两次****Shift快捷键，打开代码查找界面，在搜索框中输入需要查找内容，下方窗口实时展示搜索结果。单击查找的结果可以快速打开所在文件的位置。

快速查阅API接口及组件参考文档

在编辑器中调用ArkTS/JS API或组件时，支持在编辑器中快速、精准调取出对应的参考文档。

可在编辑器中，鼠标悬停在需要查阅的接口或组件，弹窗将显示当前接口/组件在不同API版本下的参数等信息，单击弹窗右下角Show in API Reference ，或选中接口或组件，右键点击Show in API Reference，可以快速查阅更详细的API文档。

说明

DevEco Studio集成了离线版API参考类文档，最新版本请参考官网HarmonyOS API参考。

在弹窗中可以查看：

  1. 使用的API是否涉及权限申请或仅支持在测试框架下使用。
  2. 使用的接口状态。deprecated 标签表示即将废弃的API接口，可使用useinstead标记的API进行替代，请开发时关注。

Optimize Imports功能

使用编辑器提供的Optimize Imports，可以快速清除未使用的import，并根据设置的规则对import进行合并或排序。选择文件或目录，使用快捷键Ctrl+Alt+O （macOS为Control+Option+O ），或单击菜单栏Code > Optimize Imports。

如需修改优化配置，进入File > Settings （macOS为****DevEco Studio > Preferences/Settings*） > Editor > Code Style，选择开发语言（当前以ArkTS为例），在Imports*标签页中，可选择在优化时是否需合并来自同一模块的import，是否需要对同一条import语句导入的元素进行排序，或对多条import语句按模块排序。

API变更查询

从DevEco Studio 5.1.0 Release版本开始支持，DevEco Studio中支持查询、对比从某个选定的SDK版本开始，当前工程中使用到的ArkTS API是否存在行为变更，并提供相应适配指导链接，帮助开发者完成工程代码适配修改。

从DevEco Studio 5.1.1 Release版本开始，支持对C API的变更情况进行查询，提供跨版本查询能力。

使用约束

  • 废弃的API函数变更时，不支持查询。

  • ArkTS API函数调用过程中，当开发者使用的API存在泛型参数和包含extends或keyof关键字时，不支持变更查询。示例如下：

    cangjie 复制代码 
    // API定义interface ProgressInterface {  <Type extends keyof ProgressStyleMap>(options: ProgressOptions<Type>): ProgressAttribute<Type>;   //包含extends或keyof关键字不支持变更查询}// API调用Progress({ value: 10, type: ProgressType.Capsule }).style({content:'Install'})

  • 使用C++语法实现的API函数变更时，不支持查询。示例如下：

    cpp 复制代码 
    template <class _Rep, class _Period>cv_status condition_variable::wait_for(unique_lock<mutex>& __lk,const chrono::duration<_Rep, _Period>& __d)  //C++语法实现的API函数不支持查询

  • 特殊调用方式下的API函数变更时，不支持查询。示例如下：

    objectivec 复制代码 
    // 反例：函数指针方式int (*sigptr)(int, const struct sigaction *__restrict, struct sigaction *__restrict) = &sigaction;sigptr(NULL,NULL);// 反例：回调方式callback(sigaction);// 反例：自定义宏#define MySig sigactionMySig(NULL,NULL);

操作步骤

使用DevEco Studio 6.0.0 Release及以上版本，按以下步骤操作：

  1. 在菜单栏点击Tools > API Change Assistant ，编辑区下方的API Change Assistant页签中，支持按模块查看API变更情况，选择需要对比的SDK版本号范围，点击Start Scan开始扫描。

    说明

    API变更查询以选择的起始版本为基线，查询当前工程中所使用的API是否存在行为变更。如选择的SDK版本为5.0.0(13) Release 到 6.0.0(20) Beta3，查询的是5.0.0(14) Beta1到6.0.0(20) Beta3版本相比对的API变更。

  2. 点击扫描结果中的代码地址，跳转到相应的代码编写位置；如需更多指导可点击链接图标，跳转至版本说明文档中查看详情；修改完后可点击图标，标注已修改。同时，可通过如下入口搜索或筛选API变更扫描结果、导出扫描结果数据等。

    • Search：支持在Search框中输入API名称或文件路径，对扫描结果搜索。
    • API Version：通过选择API版本，对扫描结果筛选。
    • Change ID：对行为变更API进行编号，通过变更ID，对扫描结果筛选。
    • Lauguage：通过ArkTS或C语言，对扫描结果筛选。
    • API ID：通过行为变更的API接口，对扫描结果筛选。
    • Fix Status：API变更扫描结果的修复情况，All表示所有，Fixed表示已修复，Unfixed表示未修复。通过修复情况，对扫描结果筛选。
    • Scan Again：重新扫描。
    • Export：选择位置后，导出API变更扫描结果数据。
    • Settings：设置在扫描API时，可使用的最大堆内存的大小，默认值为3072MB。当工程代码量较大导致扫描缓慢时，可以调整该参数。

使用DevEco Studio 6.0.0 Release以下版本，按以下步骤操作：

  1. 在菜单栏点击Tools > API Change Assistant ，编辑区下方的API Change Assistant页签中，支持按模块查看API变更情况，选择需要对比的SDK版本号范围，点击Start Scan开始扫描。

    说明

    API变更查询以选择的起始版本为基线，查询当前工程中所使用的API是否存在行为变更。如选择的SDK版本为5.0.0(13) Release 到 6.0.0(20) Beta3，查询的是5.0.0(14) Beta1到6.0.0(20) Beta3版本相比对的API变更。

  2. 点击Code Location中的代码地址，跳转到相应的代码编写位置；如需更多指导，可点击Guidance link中的链接，跳转至版本说明文档中查看详情。

  3. 点击Export ，选择API变更的存放位置后导出变更数据；点击Scan Again 可重新进行扫描。通过右侧Settings按钮，可以设置在扫描API时，可使用的最大堆内存的大小，默认值为3072MB，当工程代码量较大导致扫描缓慢时，可以调整该参数。

父/子类快速跳转

编辑器支持快速跳转至当前接口、类、方法、属性的子类/父类。点击代码编辑区域左侧的Gutter Icons（装订线图标）可以跳转到对应的父/子接口或类。如有多个继承关系，在弹窗的文件列表中选择需要查看的接口/类即可。

  • Implemented：支持跳转到对应的实现类或子接口及其对应的属性/方法。
  • Implementing：支持跳转到对应的父接口或父接口的属性/方法。
  • Overridden：支持跳转到对应的子类或子类的属性/方法。
  • Overriding：支持跳转到对应的父类或父类的属性/方法。

本功能默认开启，可以通过菜单栏进入File > Settings （macOS为****DevEco Studio > Preferences/Settings****） > Editor > General > Gutter Icons，通过勾选或取消勾选Implemented、Implementing、Overridden、Overriding四项可以开启或关闭该功能。

查看接口/类的层次结构

编辑器支持查看当前接口/类父类或子类的层次结构。选中或将光标放置于类/接口名称处，使用快捷键Ctrl+H （macOS为Control+H ），或在菜单栏Navigate 页签下选择Type Hierarchy，在弹出的Hierarchy窗口中查看接口/类的继承关系结构。

Hierarchy窗口按钮功能：

图标 功能
显示所选类的父类和子类。该功能不支持查看接口的继承关系。
显示当前类/接口的父类。
显示当前类/接口的子类。
按字母顺序对继承关系结构树中的所有同级元素进行排序。
更新显示所有的类/接口的继承关系结构。
默认双击结构树中类/接口名称时，编辑窗口将跳转至所选类/接口所在的代码位置。勾选该选项后，单击结构树中类/接口名称，即可跳转访问。
展开/折叠继承关系结构。
锁定当前Hierarchy窗口显示于编辑窗口上。
将类/接口的继承关系结构导出到文本文件中。
关闭工具窗口。

添加嵌入提示

从DevEco Studio 6.0.0 Beta2 版本开始，在编辑时启用Inlay Hints嵌入提示功能，可以提供有关参数名称、类型等代码说明信息，提升代码可读性。

进入File > Settings （macOS为DevEco Studio > Preferences****/Settings ） > Editor > Inlay Hints ，配置勾选希望展示的变量名称、属性、参数、返回值类型，点击OK后生效。

Copy Reference

从DevEco Studio 6.0.0 Beta2 版本开始，在编辑页面选中代码行或类、方法、参数、变量等名称，右键选择Copy / Paste Special > Copy Reference ，将自动复制定义处的地址。复制成功的地址可以在双击Shift弹出的搜索框中进行搜索，帮助开发者快速找到该接口的定义位置。

代码自动补全

提供代码的自动补全能力，编辑器工具会分析上下文，并根据输入的内容，提示可补全的类、方法、字段和关键字的名称等，支持模糊匹配。

自动补齐功能默认按最短路径进行排序，如仅需按照最近使用过的类、方法、字段和关键字等名称提供补全内容排序，可以在File > Settings （macOS为DevEco Studio > Preferences/Settings ） > Editor > General > Code Completion 中勾选"Sort suggestions by recently used"。

说明

若已勾选代码补齐按最近使用排序但未生效，请检查Code Completion页面，确保"Sort suggestions alphabetically"已取消勾选。

快速覆写父类

DevEco Studio提供Override Methods，辅助开发者根据父类模板快速生成子类方法，提升开发效率。将光标放于子类定义位置，使用快捷键Ctrl+O （macOS为Control+O ），或右键单击Generate ...，选择Override Methods ，指定需要覆写的对象（方法、变量等），点击OK将自动生成该对象的覆写代码。

快速生成构造器

编辑器支持为类快速生成一个对应的构造函数。

在类中使用快捷键Alt+Insert （macOS为Command+N ），或单击鼠标右键选择Generate ...，在弹窗中选择Constructor ，选择一个或多个需要生成构造函数的参数，点击OK 。若选择Select None，则生成不带参数的构造器。

快速生成get/set方法

编辑器支持为类成员变量或对象属性快速生成get和set方法。

将光标放置在当前类中，单击右键选择Generate...>Getter and Setter ，或者使用快捷键Alt+Insert （macOS为Command+N ），在菜单中选择Getter and Setter，完成方法快速生成。

快速生成声明信息到Index文件

编辑器支持将HSP和HAR模块中变量、方法、接口、类等需要对外暴露的信息，通过Generate...>Declarations功能，批量在Index.ets文件中进行声明，便于其他模块调用。

在HSP或HAR模块内的文件编辑界面，单击右键选择Generate...>**Declarations，或者使用快捷键 Alt+Insert**（macOS为****Command+N*），在菜单中选择Declarations*，按住快捷键Ctrl并选择需要声明的变量名、方法名、接口名、类名等，即可在模块的Index.ets文件中批量生成相应的声明信息。

实时检查

编辑器会实时的进行代码分析，如果输入的语法不符合编码规范，或者出现语义语法错误，将在代码中突出显示错误或警告，将鼠标放置在错误代码处，会提示详细的错误信息。

从DevEco Studio 4.0 Release版本开始，当compileSdkVersion≥10时，编辑器代码实时检查支持ArkTS性能语法规范检查。

说明

当前compileSdkVersion≥10且arkTSVersion≥1.1(默认)时，ArkTS严格类型检查支持实时检查。

代码快速修复

DevEco Studio支持代码快速修复能力，辅助开发者快速修复ArkTS或C++代码问题。

查看告警信息：使用双击Shift 快捷键打开文件查询框，输入problems打开问题工具面板；双击对应告警信息，可以查看告警的具体位置及原因。

快速修复：将光标放在错误告警的位置，可在弹出的悬浮窗中查看问题描述和对应修复方式；单击M****ore actions可查看更多修复方法。或是在页面出现灯泡图标时，可点击图标并根据相应建议，实现代码快速修复。

C++快速修复使用演示

下面通过示例展示C++代码中快速修复功能的使用方法。

填充switch语句

编辑器支持快速修复方式，对C++代码自动补齐switch条件表达式缺失的case条件，提升编码效率。

光标悬浮在switch表达式的条件变量处，点击灯泡图标，在下拉菜单中选择Create missing switch cases，完成缺失的case条件补充。

使用auto替换类型

编辑器中可以用 auto 替换 iterator，new expression，cast expression的声明类型。光标悬浮在类型名称处，点击灯泡图标，在下拉菜单中选择**Replace the type with 'auto****'**完成替换。

用?:三元操作符替换if-else

编辑器中支持将if-else语句替换为?:三元操作符。光标放在if表达式的条件处，左侧出现黄色灯泡图标，点击灯泡图标，在下拉菜单中选择**Replace 'if else' with '?:'**完成替换。

从使用处生成构造函数

如使用了未定义的构造函数，可通过quickfix方式快速生成相应的构造函数定义。点击构造函数名称，左侧出现红色灯泡后，点击灯泡图标选择**Create new constructor 'xxx'**生成构造函数。

将变量拆分为声明和赋值

光标点击需要拆分的变量，左侧出现黄色灯泡后，点击灯泡图标选择Split into declaration and assignment，将变量的声明赋值语句拆分成声明语句和赋值语句。

Code Linter支持对模块内文件或文件夹中的代码进行最佳实践/编程规范方面的检查。检查规则支持配置，配置方式请参考配置代码检查规则。

开发者可根据扫描结果中告警提示手工修复代码缺陷，或者执行一键式自动修复，在代码开发阶段，确保代码质量。

检查方法：

在已打开的代码编辑器窗口单击右键点击Code Linter ，或在工程管理窗口中鼠标选中单个或多个工程文件/目录，右键选择Code Linter > Full Linter执行代码全量检查。

如只需对Git工程中增量文件（包含新增/修改/重命名）进行检查，可在commit界面右下角点击齿轮图标，选择Incremental Linter执行增量检查。

说明

  • 若未配置代码检查规则文件，直接执行Code Linter，将按照默认的编程规范规则对.ets文件进行检查。
  • Code Linter不对如下文件及目录进行检查：
    • src/ohosTest文件夹
    • /src/test文件夹
    • node_modules文件夹
    • oh_modules文件夹
    • build文件夹
    • .preview文件夹
    • hvigorfile.ts文件
    • hvigorfile.js文件
    • BuildProfile.ets文件

配置代码检查规则

新建工程时，工程根目录下默认创建code-linter.json5配置文件，可对代码检查的范围及对应生效的检查规则进行配置。若使用历史工程进行开发，可在工程中右键选择Code Linter > Generate Config File创建code-linter.json5配置文件。

其中files和ignore配置项共同确定了代码检查范围，ruleSet和rules配置项共同确定了生效的规则范围。具体配置项功能如下：

files：配置待检查的文件名单，如未指定目录，将检查当前被选中的文件或文件夹中所有的.ets文件。

ignore：配置无需检查的文件目录，其指定的目录或文件需使用相对路径格式，相对于code-linter.json5所在工程根目录，例如：build/**/*。

ruleSet ：配置检查使用的规则集，规则集支持一次导入多条规则。规则详情请参见Code Linter代码检查规则。目前支持的规则集包括：

  • 通用规则@typescript-eslint

  • 安全规则@security

  • 性能规则@performance

  • 预览规则@previewer

  • 一次开发多端部署规则@cross-device-app-dev

  • ArkTS代码风格规则@hw-stylistic

  • 正确性规则@correctness

    说明

    • 以上规则集均分为all和recommended两种规则集。all规则集是规则全集，包含所有规则；recommended规则集是推荐使用的规则集合。all规则集包含recommended规则集。
    • 不在工程根目录新建code-linter.json5文件的情况下，Code Linter默认会检查@performance/recommended和@typescript-eslint/recommended规则集包含的规则。

rules：可以基于ruleSet配置的规则集，新增额外规则项，或修改ruleSet中规则默认配置，例如：将规则集中某条规则告警级别由warn改为error。

overrides：针对工程根目录下部分特定目录或文件，可配置定制化检查的规则。

extRuleSet ：配置需要检查的自定义规则，具体请参考：自定义规则开发指南。该字段从DevEco Studio 5.1.0 Release版本开始支持。

cangjie 复制代码 
{  "files":   //用于表示配置适用的文件范围的 glob 模式数组。在没有指定的情况下，应用默认配置  [    "**/*.js", //字符串类型    "**/*.ts"  ],  "ignore":  //一个表示配置对象不应适用的文件的 glob 模式数组。如果没有指定，配置对象将适用于所有由 files 匹配的文件  [    "build/**/*",    //字符串类型    "node_modules/**/*"  ],  "ruleSet":       //设置检查待应用的规则集  [    "plugin:@typescript-eslint/recommended"    //快捷批量引入的规则集, 枚举类型：plugin:@typescript-eslint/all, plugin:@typescript-eslint/recommended, plugin:@cross-device-app-dev/all, plugin:@cross-device-app-dev/recommended等  ],  "rules":         //可以对ruleSet配置的规则集中特定的某些规则进行修改、去使能, 或者新增规则集以外的规则；ruleSet和rules共同确定了代码检查所应用的规则  {    "@typescript-eslint/no-explicit-any":  // ruleId后面跟数组时, 第一个元素为告警级别, 后面的对象元素为规则特定开关配置    [      "error",              //告警级别: 枚举类型, 支持配置为suggestion, error, warn, off      {        "ignoreRestArgs": true   //规则特定的开关配置, 为可选项, 不同规则其下层的配置项不同      }    ],    "@typescript-eslint/explicit-function-return-type": 2,   // ruleId后面跟单独一个数字时, 表示仅设置告警级别, 枚举值为: 3(suggestion), 2(error), 1(warn), 0(off)    "@typescript-eslint/no-unsafe-return": "warn"            // ruleId后面跟单独一个字符串时, 表示仅设置告警级别, 枚举值为: suggestion, error, warn, off  },  "overrides":      //针对特定的目录或文件采用定制化的规则配置  [    {      "files":   //指定需要定制化配置规则的文件或目录      [        "entry/**/*.ts"   //字符串类型      ],      "excluded":      [        "entry/**/*.test.js" //指定需要排除的目录或文件, 被排除的目录或文件不会按照定制化的规则配置被检查; 字符串类型      ],      "rules":   //支持对overrides外公共配置的规则进行修改、去使能, 或者新增公共配置以外的规则; 该配置将覆盖公共配置      {        "@typescript-eslint/explicit-function-return-type":  // ruleId: 枚举类型        [          "warn",     //告警级别: 枚举类型, 支持配置为error, warn, off; 覆盖公共配置, explicit-function-return-type告警级别为warn          {             "allowExpressions": true    //规则特定的开关配置, 为可选项, 不同规则其下层的配置项不同          }        ],        "@typescript-eslint/no-unsafe-return": "off"   // 覆盖公共配置, 不检查no-unsafe-return规则      },      "extRules": {     //支持对overrides外自定义规则集配置的规则进行修改、去使能; 该配置将覆盖自定义规则配置        "@extrulesproject/foreach-args-check": "off"   // 覆盖自定义规则配置, 不检查@extrulesproject/foreach-args-check规则      }    }  ],  "extRuleSet": [     //自定义规则集的配置    {        "ruleSetName": "extrulesproject",     //自定义规则库的名称。格式为@group/packagename或者packagename，全局唯一。除@和/外，group和packagename只能包含小写字母、数字、下划线（_）和中划线(-)。总长度小于等于128个字符。另外，group和packagename必须以字母开头，不能作为ArkTS的保留关键字        "packagePath": "D:\\checker\\extrulesproject-1.0.0.tgz",     //自定义规则安装包路径，需使用绝对路径        "extRules": {     //自定义规则名称以及告警等级，枚举值为: 3(suggestion), 2(error), 1(warn), 0(off)          "@extrulesproject/foreach-args-check": 1        }    }  ]}

查看/处理代码检查结果

扫描完成后，在底部工具面板查看检查结果。勾选Defects中不同告警等级，可分别查看对应告警级别的信息。双击某条告警结果，可以跳转到对应代码缺陷位置；选中告警结果时，可以在右侧Defect Description窗口查看告警对应的规则详细说明，其中包含正向和反向示例，并根据其中的建议修改代码；搜索规则时，可设定是否全词匹配和大小写敏感。

单击图标，查看可修复的代码规则，点击代码修复图标，可以一键式批量修复告警，并刷新检查结果。

屏蔽告警信息：

  • 在某些特殊场景下，若扫描结果中出现误报，点击单条告警结果后的Ignore 图标**，可以忽略对告警所在行的code linter检查；或勾选文件名称或多条待屏蔽的告警，点击左侧工具面板Ignore**图标批量执行操作；
  • 在文件顶部添加注释/* eslint-disable */可以屏蔽整个文件执行code linter检查，在eslint-disable 后加入一个或多个以逗号分隔的规则Id，可以屏蔽具体检查规则；
  • 在需要忽略检查的代码块前后分别添加/* eslint-disable /和/ eslint-enable */添加注释信息，再执行**Code Linter，*将不再显示该代码块扫描结果；在待屏蔽的代码行前一行添加/ eslint-disable-next-line */，也可屏蔽对该代码行的Code Linter检查。

如需恢复忽略的报错信息，可以直接删除该行上方的注释，重新执行Code Linter检查。

导出检查结果 ：点击工具面板左侧导出按钮，即可导出检查结果到excel文件，包含告警所在行，告警明细，告警级别等信息。

实践说明

以@typescript-eslint/no-restricted-syntax（使用某类语法时，codelinter告警）、@typescript-eslint/naming-convention（命名风格校验）和@hw-stylistic/file-naming-convention（检查代码文件的命名风格）三个规则为例，介绍codelinter配置文件的使用方法。

示例1：调用类Foo下bar方法时，Code Linter告警

在配置文件中定义规则

在ArkTS工程中，pages/Index.ets文件下增加以下用例：

csharp 复制代码 
class Foo {  static bar() {}}
Foo.bar();

在工程根目录下新建code-linter.json5文件（文件名不可修改），新增以下配置：

cangjie 复制代码 
{  "rules": {    "@typescript-eslint/no-restricted-syntax": [      // 告警级别: 枚举类型, 支持配置为error, warn, off      "error",      {        // selector属性必选，配置要禁用的语法        // 可通过特定DSL筛选待限制的语句，CallExpression表示方法调用表达式，后面的中括号里面是筛选条件（根据语法树Node节点来确定）        // 其中callee.object.name根据指定的名称筛选调用方法的对象（class，namespace或module），以上示例中为"Foo"        // callee.property.name则根据指定的名称筛选被调用的方法，以上示例中为"bar"        "selector": "CallExpression[callee.object.name='Foo'][callee.property.name='bar']",        // message属性可选，配置要展示的报错信息        "message": "Foo.bar() is not allowed"      }    ]  },}

说明

如需在code-linter.json5文件中配置其他字段，请参见配置代码检查规则。

执行代码检查

对pages/Index.ets文件执行代码检查，检查结果如下：

示例2：对类名Foo的命名风格校验

在配置文件中定义规则

在ArkTS工程中，pages/Index.ets文件下增加以下用例：

javascript 复制代码 
class foo {    //此处构造一个命名风格错误的示例，foo为错误使用类名，正确类名应为Foo  bar() {} }

在工程根目录下新建code-linter.json5文件，新增以下配置：

cangjie 复制代码 
{  "rules": {    "@typescript-eslint/naming-convention": [      "error",      {        // selector属性必选，配置要检查的语法，这里配置的class表示检查自定义组件名        "selector": "class",        // format属性必选，配置期望的命名风格，支持枚举值，这里配置的PascalCase表示大驼峰风格        "format": ["PascalCase"],        // custom属性可选，配置用户自定义的命名风格        "custom": {          // regex属性必选，配置具体的正则          "regex": "^[a-zA-Z]+$",          // match属性必选，配置为true表示正则未命中时报错；配置为false表示正则命中时报错          "match": true        }      }    ]  },}
字段名称 参数说明 是否必选 类型 支持配置的参数
selector 配置要检查的语法 是 字符串、字符串数组 variable：变量function：函数parameter：参数parameterProperty：参数属性accessor：get/set方法enumMember：枚举成员classMethod：类方法structMethod：自定义组件中的方法objectLiteralMethod：对象方法typeMethod：接口方法classProperty：类属性structProperty：自定义组件中的属性objectLiteralProperty：对象属性typeProperty：接口属性class：类struct：自定义组件interface：接口typeAlias：类型别名enum：枚举typeParameter：泛型参数default：包含以上所有的类型variableLike：包含variable，function，parametermemberLike：包含classProperty，structProperty，objectLiteralProperty，typeProperty，parameterProperty ，enumMember，classMethod，objectLiteralMethod，typeMethod，accessortypeLike：包含class，struct，interface，typeAlias，enum，typeParametermethod：包含classMethod，structMethod，objectLiteralMethod，typeMethodproperty：包含classProperty，objectLiteralProperty，typeProperty
format 配置期望的命名风格 是 字符串数组 camelCase：小驼峰命名风格，比如getName，getID（支持连续大写字母），不支持下划线strictCamelCase：严格小驼峰命名风格，除了不支持连续大写字母（getID），其他的和camelCase相同PascalCase：大驼峰命名风格，比如Foo，CC，除了要求第一个字母大写，其他的和camelCase相同StrictPascalCase：大驼峰命名风格，除了不支持连续大写字母（CC），其他的和PascalCase相同snake_case：小写字母+下划线+小写字母的命名风格，比如a_a，不支持_a，a_a_UPPER_CASE：大写字母+下划线+大写字母的命名风格，比如A_A，不支持_A，A_A_
custom 配置用户自定义的命名风格 否 对象 regex：属性必选，配置具体的正则match：属性必选，配置为true表示正则未命中时报错，配置为false表示正则命中时报错
leadingUnderscore/trailingUnderscore 配置是否允许以下划线开头/以下划线结尾的命名风格 否 字符串 allow：允许以一个下划线开头/结尾的命名风格，比如_nameallowDouble：允许以两个下划线开头/结尾的命名风格，比如__nameallowSingleOrDouble：允许以一个或者两个下划线开头/结尾的命名风格（allow+allowDouble）forbid：禁止以下划线开头/结尾的命名风格，比如_name，__namerequire：必须是以下划线开头/结尾的命名风格，比如_name，__namerequireDouble：必须是以两个下划线开头/结尾的命名风格，比如__name
prefix/suffix 配置固定前缀/后缀的命名风格。如果前缀/后缀未匹配则报错 否 字符串数组 用户自定义前缀/后缀
filter 过滤特定的命名风格，检查或者不检查正则命中的命名 否 对象 配置格式与custom相似match：设置为true表示只检查正则命中的名字，设置为false表示不检查正则命中的名字regex：设置过滤的正则说明支持直接配置一个字符串，这个字符串配置的是regex，此时match相当于配置的是true。
modifiers 匹配修饰符，只有包含特定修饰符的命名才会检查 否 字符串数组 abstract：匹配abstract关键字override：匹配override关键字private：匹配private关键字protected：匹配protected关键字static：匹配static关键字async：匹配async关键字const：匹配const关键字destructured：匹配解构语法exported：匹配export关键字global：匹配全局声明#private：匹配私有符号#public：匹配public级别的访问修饰符requiresQuotes：匹配字符串类型的命名，并且 字符串中包含特殊字符unused：匹配未使用的声明
types 匹配类型，只有特定类型的名字才会检查 否 字符串数组 array：数组类型boolean：布尔类型function：函数类型number：数字类型string：字符串类型

说明

以上配置的参数有校验优先级：filter > types > modifiers > validate leading underscore > validate trailing underscore > validate prefix > validate suffix > validate custom > validate format。

执行代码检查

对pages/Index.ets文件执行代码检查，检查结果如下：

示例3：检查代码文件的命名风格

在配置文件中定义规则

在ArkTS工程中，pages目录下新建test.ets文件；

在工程根目录下新建code-linter.json5文件，新增以下配置：

cangjie 复制代码 
{  "rules": {    "@hw-stylistic/file-naming-convention": [      // 告警级别：枚举类型，支持配置为error，warn，off      "error",      {        // selector属性可选，支持配置为code或者resources        // code表示检查代码文件的命名风格        // resources表示检查资源文件的命名风格        "selector": "code"      }    ]  },}

说明

如果selector属性不配置，默认检查代码文件和资源文件的命名风格。

执行代码检查

对pages/test.ets文件执行代码检查，检查结果如下：

相关推荐
Devil枫2 小时前
鸿蒙系统敏感文件安全存储：从系统机制到 ArkTS 实现
安全·华为·harmonyos
安卓开发者2 小时前
鸿蒙Next密码自动填充服务：安全与便捷的完美融合
安全·华为·harmonyos
我是华为OD~HR~栗栗呀5 小时前
测试转C++开发面经（华为OD）
java·c++·后端·python·华为od·华为·面试
万少5 小时前
记 HarmonyOS 开发中的一个小事件 怒提华为工单
前端·harmonyos
辛宝Otto_WebWorker5 小时前
自力更生！uniapp 使用鸿蒙 UTS 使用三方依赖、本地依赖
uni-app·harmonyos
程序员潘Sir7 小时前
使用Tabs选项卡组件快速搭建鸿蒙APP框架
harmonyos·鸿蒙
编程乐学8 小时前
鸿蒙原创--DevEco Studio开发的音乐播放器App
华为·harmonyos·音乐播放器·deveco studio·大作业·鸿蒙大作业
^Lim13 小时前
vscode连接ubuntu18报Gilbc2.28错
ide·vscode·编辑器
热门推荐
01Multisim使用教程详尽版--(2025最新版)02UV 工具安装与国内镜像源配置指南03GitHub 镜像站点04UV安装并设置国内源0546个Nano-banana 精选提示词，持续更新中06Spec-Kit 使用指南07KGG转MP3工具|非KGM文件|解密音频08VsCode远程Copilot无法使用Claude Agent问题09保姆级教程：手把手教你用Dify实现完美多轮对话（附Chatflow和提示词）10Linux下V2Ray安装配置指南