# 代码重构

## ArkTS/TS代码重构

### Refactor-Extract代码提取

在编辑器中支持将函数内、类方法内等区域代码块或表达式，提取为新方法/函数（Method）、常量（Constant）、接口（Interface）、变量（Variable）或类型别名（Type Alias）。准确便捷的将所选区域代码从当前作用域内进行提取，提升编码效率。选中所需要提取的代码块，右键单击**Refactor**，选择需要提取的类型。
> 说明
>
> Refactor-Extract代码提取为类型别名（Type Alias）能力仅TS语言支持。

方法/函数（Method）支持选中代码块或完整语句进行提取：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/27/v3/nr12W-MwT4imfpXLEq-4DQ/zh-cn_image_0000002731543223.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=62C2CFFF995F61E9D333A16D37B89BEB39458EAD0278085BD5476692793486A9 "点击放大")

在ArkTS语言中，支持将组件调用代码块提取为@Builder装饰器装饰的方法，组件属性调用表达式可提取为@Styles或@Extend装饰器装饰的方法。

**使用方式** ：选中需要提取的组件或属性，右键单击**Refactor** ，选择**Extract Method...**，组件私有属性可提取为@Extend装饰的方法，通用属性可提取为@Styles或@Extend装饰的方法。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/43/v3/k9edLin6Q9iym1sz5oS5ew/zh-cn_image_0000002731383253.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=3B75656399833B1D38716A5894DC5407061B565A098CC3F4470AC25C37659FEC "点击放大")

常量（Constant）支持选中单行表达式进行提取：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/31/v3/DEyTkqhGTpClnPMFZ4T-tQ/zh-cn_image_0000002701664028.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=FE7E9866E7EF91B2E459D9783E427C396892FD11A1F5C429DB6C434C2B638F6A "点击放大")

接口（Interface）支持选中对象自变量进行提取：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5b/v3/PtUxO6tBS9-lE1IDCDXP7Q/zh-cn_image_0000002701664030.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=D64E3906163F9C398922B0BFECD2104E7FDC34D0A326707E4BB6FAFC4E6F25AF "点击放大")

支持选中表达式提取为变量（Variable）：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/de/v3/H-InvdGPQtCuj6lo1cfJdg/zh-cn_image_0000002731383247.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=F803DDE5D07C991E2B0171740439C4DF551F16199AAD23109A2C2BD0B625DC3C "点击放大")

### Refactor-Convert代码转换

编辑器内提供Convert重构能力，支持Convert between named imports and namespace imports等高频转换操作，辅助开发者高效重构代码，提升代码质量。

|功能|说明|使用方法|支持转换的源码类型|
|:----------------------------------------|:--------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------|
|Convert to class|将JS源码中的function转换为符合ES6标准的类|点击或选中function名，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。 > 说明 > 若当前工程中已引用该方法，执行Convert to class后，在Find Usages中可查看引用的具体位置，点击**Do Refactor**可忽略冲突并执行转换；也可以逐条修改引用位置的代码后，重新执行上述操作。|JS|
|Convert to anonymous function|将箭头函数转换为匿名函数|选中箭头函数赋值变量，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。|JS/TS|
|Convert to named function|将箭头函数转换为普通函数|选中箭头函数赋值变量，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。|JS/TS/ArkTS|
|Convert to arrow function|将匿名函数转换为箭头函数|选中匿名函数赋值变量，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。|JS/TS/ArkTS|
|Convert default export to named export|支持named export和default export相互转换|完整选中export default语句，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。|JS/TS/ArkTS|
|Convert named export to default export|支持named export和default export相互转换|完整选中export语句，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。|JS/TS/ArkTS|
|Convert named imports to namespace import|支持在命名import和命名空间import形态间转换|完整选中import语句，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。|JS/TS/ArkTS|
|Convert namespace import to named imports|支持在命名import和命名空间import形态间转换|完整选中命名空间import语句，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。|JS/TS/ArkTS|
|Convert to template string|将字符串转换为模板字面量|选中字符串或完整表达式，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。|JS/TS/ArkTS|
|Convert to optional chain expression|将判空逻辑转换为可选链式调用|选中连续判空表达式，右键单击**Refactor** > **Convert** ，或使用快捷键**Ctrl+Alt+Shift+R** （macOS为**Option+Shift+Command+R**），在弹窗中选择转换的方式。|JS/TS/ArkTS|
[**表1**Refactor-Convert功能支持清单]

### Refactor-Rename代码重命名

代码编辑支持Rename功能，可以快速更改变量、方法、对象属性等相关标识符及文件、模块的名称，并同步到整个工程中对其进行引用的位置。

**使用方式** ：选中需要重新命名的标识符（变量、类、接口、自定义组件等），右键单击**Refactor** ，选择**Rename...** （或使用**快捷键Shift+F6** ），在弹框中输入新的标识符名称，并在**Scope** 中选择替换的范围，点击**Refactor**完成重新命名。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/24/v3/bmTbe2fwRlS_5sq6H8sJ4Q/zh-cn_image_0000002731543221.png?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=88478DC15E3164C9559B8E313E0929312A3157F4E4A4853CE1374B263709C78E)

代码编辑支持筛选并过滤不需要rename的引用位置。在**Rename...** 弹窗中点击**Preview** ，在弹出预览窗口中，用户选中无需Rename的选项，单击右键菜单**Exclude** **/Remove** 进行过滤/删除，完成筛选后点击左下角**Do Refactor**，重新执行Rename操作。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0f/v3/TwZ00L94Tz6e0j8N3O88Ig/zh-cn_image_0000002731543227.png?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=0C039978F5F685C90F93B405318BBFA550868CA8AF731A6AE1869E0AD9F27238)
> 说明
>
> 若ArkTS文件中存在C++接口调用，使用Rename进行重命名时，C++文件中涉及的函数名也会被重命名。

### Move File

在文件中单击右键，选择**Refactor > Move File...** ，在弹窗中输入或点击**...** 选择指定的目录，点击**Refactor** ，可将当前文件移动至该目录下。勾选**Search for references** ，可查找并更新工程中对该文件的引用；勾选**Open in editor**，可在编辑器中查看移动的文件。

从26.0.0版本开始，针对跨模块移动文件场景优化了移动符号的导入方式，移入、移出模块时Index.ets会适配改动。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9c/v3/Z37pBCa1SKq-JZae9nwesA/zh-cn_image_0000002731383251.png?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=E1C3CF395BCC336F282E8988444B1E6F29E36FF990E1E7D5B373309A89DAAFBE)

### Safe Delete

编辑器支持Safe Delete功能，帮助您安全地删除代码中的标识符对象（变量、函数或类等）或删除指定文件。在删除前，编辑器将先在代码中搜索对该对象的引用，如果存在引用，编辑器将提示您进行必要的检查和调整。

**使用方式** ：在编辑器内选中需要删除的标识符对象或在工程目录选择待删除的文件，右键单击**Refactor** ，选择**Safe Delete** ，单击**OK** 将自动检查当前对象在代码中被引用的情况，点击**View Usages** 可查看具体使用的代码内容，点击**Delete Anyway**将直接删除该对象的定义。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4e/v3/zd6MJ2-qQXaSTcwGisNBLw/zh-cn_image_0000002731383249.png?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=0E915E55262341765ACC44740C17FBD903D1D682E4969FE8DB67FA548BB10740)

## C++代码重构

编辑器提供C++代码重构能力，当前支持展开宏、交换if分支、移动函数体到声明处等使用场景下的重构能力，提升开发效率。

### 展开宏

支持在当前宏引用处展开宏。将光标移动至需要展开的宏，右键单击**Refactor** ，选择**Inline**，展开此处引用的宏。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f7/v3/1jGnuCxBTa2N5KSjZJsgrw/zh-cn_image_0000002731383245.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=893049D18475B6C6F668C9BFA3C91DC880273A24DD62A6192C7167709BE51057)

### 交换if分支

编辑器支持在选中if-else完整代码块的情况下，实现对if-else代码块的位置交换，并对条件取反。

**使用约束**

* 需要重构的代码块必须为完整的if-else代码结构，{}不能省略；
* if-else中的statement包含嵌套if-else语句时，只反转最外层的if-else语句。对于if() -else if()-else() 结构，仅支持对最后一层if-else结构进行交换；
* 不支持赋值语句的判断条件取反。

**使用方式**

编辑器内选择需要转换的代码区域，右键单击**Refactor** ，选择**Swap If Branches**，对原有if条件取反，并交换if-else原代码块顺序。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fb/v3/geBRdZ_kQnyi8pyiL6bbEQ/zh-cn_image_0000002701823950.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=6E0B29FF9DDB88F8599F48E6B3F5CE7E021BD7BF934F0FF33C5D9E508609660A "点击放大")

### 移动函数体到声明处

编辑器支持将函数体从源文件移动到头文件中，提高代码可读性。编辑器内选中函数名，右键单击**Refactor** ，选择**Move to Declaration**，源文件中的函数实现将移动至头文件中。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/48/v3/p7v_63mhR5Wqgj54DRrLXQ/zh-cn_image_0000002701664026.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=E6C8A3F5D8A913529FEAEFA56F9A3BE102080D9A4C66DEA598FE19C79701AC6F)

### 移动函数体到实现处

在编辑器内将光标放在或选中函数名，右键单击**Refactor** ，选择**Move to Implementation**，选择移动到的文件，将函数定义移动到该文件。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e3/v3/yCBOftehTjSMRKe2kVvlsw/zh-cn_image_0000002701664032.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=8B102913309DC0D6AAB7D24C9C7B2D13AAC491B0F07E152116F0F2C3947BAE19)

### 将语句转为原始字符串

编辑器提供重构能力，支持将带有 \n, \t, \", \\, \'五类转义字符的字符串转换为原始字符串。当前仅支持标准字符串，不支持 u8""等其他字符串。

在编辑器内选择字符串代码区域，右键单击**Refactor** ，选择**Convert To Raw String**，将语句转换为原始字符串。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/22/v3/VBxuNL-bSkKvkwS4PB3MgQ/zh-cn_image_0000002701823952.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=5846A6E8814877680B60F6B21A4080BB9C0186B2F11E50CEAC218A8D9F0FE306 "点击放大")

### 定义构造函数

编辑器提供重构能力，支持为类的成员变量生成默认的构造函数。

**规格限制**

1. 不支持未初始化成员变量的类
2. 不支持在（class标识符，类名，大括号）以外的位置触发
3. 不支持类已存在有入参的构造函数

**使用方法：** 在类的定义的类名处，右键单击**Generate** **...** ，选择**Constructor** ，在弹框中点击**Define**，为成员变量定义一个构造函数。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6c/v3/vnfyEDVfQaCXuhqzFX9M6A/zh-cn_image_0000002701823946.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=31145BFF06544105175E34DB68C9836D7416D9939056891211EEC005F1D63D8E)

### 提取表达式到变量

在编辑器内，选中需要提取的表达式范围，右键单击**Refactor** ，选择**Extract Variable**，支持提取表达式到变量。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7d/v3/rM5Rw1rJT62KQnH-ojLsCw/zh-cn_image_0000002731543219.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=1F8CD998F7D4B84D97C84ECFAF39D0F55BACCEF4A98AAD9B3EF2744D468CD0B5 "点击放大")

### 移除namespace

光标停留在需要移除的namespace处，右键单击**Refactor** ，选择**Remove Using Namespace**进行移除，可以避免命名冲突，提高代码可读性。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2d/v3/ClNLb1jmSDKoT0BTv6tq3g/zh-cn_image_0000002701823948.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=B6633EACE5FBBDC5B65D6615B48B8314C52D94B009AA905D6025029373CFFA93)

### 添加using声明

编辑器内，光标停留在需要添加using声明处，右键单击**Refactor** ，选择**Add Using**完成使用using定义类型别名。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4e/v3/9UFdQqe-QreoGUyRdQnNJw/zh-cn_image_0000002731543225.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=80F06624985FDD7B4FF79B6FFF9D2B71F5602CB1144E5724D42630A7B5305895)

### auto自动展开

在auto关键字处右键单击**Refactor** ，选择**Expand Auto Type**，可以使用推断类型替换auto类型。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4a/v3/ynHQETTMScaxeDmDpEcNzA/zh-cn_image_0000002701664024.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=1774CEDCFA93F9E6CF84767883B878D8920258D842090A8162A7465E605CF24A)

### 声明隐式成员

编辑器支持在类中声明隐式复制/移动成员。光标停留在需要生成的类处，右键单击**Generate** ..., 选择**Copy/Move Members**。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dd/v3/cyNhDXMHSO2D8RKGn7IwTw/zh-cn_image_0000002701823954.gif?HW-CC-KV=V1&HW-CC-Date=20261102T080734Z&HW-CC-Expire=31536000000&HW-CC-Sign=514CE3D0D6784D6F99A50824B525C04CB1977CF6D06AE3D0125504519C98D8CA)