# attach启动调试

开发者也可以通过将调试程序attach到已运行的应用进行调试。

Attach Debugger和Debug的区别在于，Attach Debugger to Process可以先运行应用/元服务，然后再启动调试，或者直接启动设备上已安装的应用/元服务进行调试；而Debug是直接运行应用/元服务后立即启动调试。

## 前提条件

当前设备上被attach的应用代码和本地代码一致，且已提前构建生成必要的sourceMap文件。

## 使用约束

attach不支持的场景：

* 本地无源码。
* bundleName不匹配，将出现提示"The selected process does not match the bundlename of the current project!"，但不阻塞调试过程。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/35/v3/IvfhPBqLTMerSkraCUsznA/zh-cn_image_0000002701823594.png?HW-CC-KV=V1&HW-CC-Date=20260909T181010Z&HW-CC-Expire=31536000000&HW-CC-Sign=95598656A4E42744C0C3630B165C390B4449C4AA987EDC8C5E038216FE0C0335)

## 操作步骤

1. 在工具栏中，选择调试的设备，并单击**Attach Debugger to Process** ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c5/v3/1i6fc_pKRTm3IAbBqZwdGw/zh-cn_image_0000002701823596.png?HW-CC-KV=V1&HW-CC-Date=20260909T181010Z&HW-CC-Expire=31536000000&HW-CC-Sign=0E643F511718B29345D1F8C2F7518AD0BBEB328C6EE0750F981DDF172024BC5A)启动调试。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/87/v3/biveLhlkQta2yyJD8mgJgw/zh-cn_image_0000002701663674.png?HW-CC-KV=V1&HW-CC-Date=20260909T181010Z&HW-CC-Expire=31536000000&HW-CC-Sign=714851E9C568E65A99D8651291BB312258490FBA119A8227A9A3792394D9DC0D)

2. 选择要调试的应用进程，若应用bundleName与当前工程不一致，则需勾选Show all process。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/17/v3/JIuDvzblQh-J05WKB4XgDQ/zh-cn_image_0000002701663676.png?HW-CC-KV=V1&HW-CC-Date=20260909T181010Z&HW-CC-Expire=31536000000&HW-CC-Sign=611B72121AA809206B20D5251780C0AF488ADBC24A2EBFD9C0FF75BA7EEC4018)
   > 说明
   >
   > 正常情况下，attach调试仅支持debug签名的应用，从DevEco Studio 6.0.2 Beta1版本开始，PC/2in1上的应用，如果使用了release签名并且配置了ohos.permission.kernel.ALLOW_DEBUG权限，也支持被attach调试。

3. 选择需要使用的调试配置，或者使用默认配置。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3e/v3/s_3bmo8mTdmWvx0g4lePaw/zh-cn_image_0000002731542867.png?HW-CC-KV=V1&HW-CC-Date=20260909T181010Z&HW-CC-Expire=31536000000&HW-CC-Sign=9DC8DB87CFB7294F481331AC099CD399919E4860E7468759B0282AD2FF97C21D)

4. 选择需要调试的Debug type，若选择已创建的Run/Debug configuration进行attach调试，此时Debug type不可改变，只可在Run/Debug configuration界面修改。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5e/v3/0Z2fTW8ET9SIgAsxd0q2hQ/zh-cn_image_0000002731382895.png?HW-CC-KV=V1&HW-CC-Date=20260909T181010Z&HW-CC-Expire=31536000000&HW-CC-Sign=829E4DFB29D4539F0BB03E6ABA961E3974EE5E08A1384BF6D1C111623EE40E4E)

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/55/v3/QJRNPjYfTUKmCc55gWbx1A/zh-cn_image_0000002701663672.png?HW-CC-KV=V1&HW-CC-Date=20260909T181010Z&HW-CC-Expire=31536000000&HW-CC-Sign=43FC658CCC1964E9284697939665876B2E395BD4C48424D277DC8C2A77FF4197)

5. 点击**OK**开始attach调试。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c9/v3/81wPVIxGRZa8zsU0sjGfUA/zh-cn_image_0000002731382897.png?HW-CC-KV=V1&HW-CC-Date=20260909T181010Z&HW-CC-Expire=31536000000&HW-CC-Sign=F6684A9E276C9F13A71DFED1F57BAD66DE94C82F930BAD25E7547165B77712E5)