ohpm list
=========

列出已安装的三方库。

#### 命令格式

ohpm list \[options\] \[\[<@group>/\]<pkg>\[@<version>\]\]
alias: ls

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/85/v3/qyGNP1tOReGVNTvx6Er37w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132926Z&HW-CC-Expire=86400&HW-CC-Sign=77E19BCDC75CB791221899A451D37A6ED62854125AD3067C3E7AB7F449E65B39)

*   @group：三方库的命名空间，可选。
*   pkg：三方库名称，可选。
*   version：三方库的版本号，可选。

#### 功能描述

以树形结构列出当前项目安装的所有三方库信息，以及它们的依赖关系。

当指定三方库名称时，会列出指定三方库名称的所有父依赖；当未指定三方库名称时，默认只列出所有的直接依赖，可通过添加选项 depth 来指定要打印的依赖层级。

#### Options

#### \[h2\]depth

*   默认值：0
*   类型：number
*   别名：d

可以在 list 命令后面配置 -d <number> 或者 --depth <number> 参数，设置输出树形结构的最大深度，超过该深度则不进行输出，不配置则取默认值 0，只展示直接依赖。

由于DevEco Studio控制台默认最多输出5000行，对于大工程建议通过 ohpm list -d <number> > fileName.txt 命令，将内容输出到指定文件中。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c2/v3/dY3ZB2LoQRiGHjZGfOLOhA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132926Z&HW-CC-Expire=86400&HW-CC-Sign=AF023402D71DDCF5AC1589DD2C3DD51B3056DC83EB20871C79B5C35483DEA400)

若输出出现乱码问题，请执行 powershell -Command "(Get-Content 'fileName.txt') -replace (\[char\]27 + '\\\[\[0-9;\]\*m'), ''" > result.txt，将内容输出到result.txt文件中。

#### \[h2\]json

*   默认值：无
*   别名：j

可以在 list 命令后面配置 -j 或者 --json 参数，以 json 格式输出当前项目安装的所有三方库信息，以及它们的依赖关系。

#### \[h2\]prefix

*   默认值：""
*   类型：string

可以在 list 命令后面配置 --prefix <string> 参数，用来指定包的根目录，该目录下必须存在 oh-package.json5 文件。

#### \[h2\]parameterFile

*   默认值：无
*   类型：string
*   别名：pf

可以在 list 命令后面配置 --pf <string> 或者 --parameterFile <string> 参数，用来指定参数化配置文件地址。使用该命令前需保证项目级别的oh-package.json5中已配置parameterFile参数。

#### \[h2\]recursive

*   默认值：无
*   别名：r

OHPM客户端从5.2.0版本开始，可以在 list 命令后面配置 -r 或者 --recursive 参数，以打印工程所有module安装的三方库信息，以及它们的依赖关系。

#### \[h2\]target\_path

*   默认值：无
*   类型：string

可以在 list 命令后面配置 --target\_path <string> 参数，用来指定在特定目标产物target语境下各模块的依赖配置文件（oh-package.json5）的路径。在执行ohpm list时，ohpm会优先安装<target\_path>/<moduleName>/oh-package.json5文件中依赖。详情参见[target\_path](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-install#section79331822125611)。

#### \[h2\]log\_level

*   默认值：无
*   类型：String

从ohpm 6.0.2.636版本开始，可以在 list 命令后配置--log\_level <string>参数，指定执行当前命令的日志级别（info、debug、warn、error），如果未指定该值则日志级别为.ohpmrc中配置的log\_level的级别。

#### \[h2\]debug

*   默认值：false
*   类型：Boolean

从ohpm 6.0.2.636版本开始，可以在命令后配置--debug参数，指定执行当前命令的日志级别为debug，该命令仅在当前命令行生效，不修改.ohpmrc中的日志级别，如果未指定该值则日志级别为.ohpmrc中配置的log\_level的级别。

#### 示例

*   查看当前项目安装的**所有**三方库及依赖关系。
    
    执行以下命令：
    
    ohpm list
    
    结果示例：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e7/v3/eJ2qiCjpRu6KcwOeUuLMqQ/zh-cn_image_0000002594475080.png?HW-CC-KV=V1&HW-CC-Date=20260709T132926Z&HW-CC-Expire=86400&HW-CC-Sign=C2F5CDC290E80E54AB959F8C9668946C89C8D2790B9CF6CBE10253252748AF6C "点击放大")
    
*   查看当前项目安装的**某个**三方库的依赖关系
    
    执行以下命令：
    
    ohpm list universalify
    
    结果示例：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/15/v3/a4TKgIGVRnKUxQ2zTM9JNw/zh-cn_image_0000002594635002.png?HW-CC-KV=V1&HW-CC-Date=20260709T132926Z&HW-CC-Expire=86400&HW-CC-Sign=B1747A38F9ADA0ADF2F537C134E72A3447F367AFA2BE475584AC1BF02BE5CFEB)
    
*   查看当前项目所有module安装的**所有**三方库及依赖关系。
    
    执行以下命令：
    
    ohpm list -r
    
    结果示例：
    
    . D:\\xxx\\ProjectName
    └── @ohos/hypium 1.0.6
    
    module1 D:\\xxx\\ProjectName\\module1
    ├─┬ lib1 1.0.0
    │ ├── lib1\_sub1 1.0.0
    │ └── lib1\_sub2 1.0.0
    └─┬ lib2 1.0.0
      ├── lib2\_sub1 1.0.0
      └── lib2\_sub2 1.0.0
    
    module2 D:\\xxx\\ProjectName\\module2
    └── @ohos/lib3 1.0.0
    

*   指定target\_path选项时，查看当前项目所有module安装的**所有**三方库及依赖关系。
    
    如果target\_path目录下新增了module：dynamic，且module1新增了依赖：lib3，执行以下命令：
    
    ohpm list -r --target\_path xxx/.hvigor/dependencyMap
    
    结果示例：
    
    . D:\\xxx\\ProjectName
    └── @ohos/hypium 1.0.6
    
    dynamic D:\\xxx\\ProjectName1\\dynamic // target\_path引入模块
    └── @ohos/lib4 1.0.0
    
    module1 D:\\xxx\\ProjectName\\module1
    ├─┬ lib1 1.0.0
    │ ├── lib1\_sub1 1.0.0
    │ └── lib1\_sub2 1.0.0
    └─┬ lib2 1.0.0
      ├── lib2\_sub1 1.0.0
      └── lib2\_sub2 1.0.0
    └── lib3 1.0.0 // target\_path新增依赖
    
    module2 D:\\xxx\\ProjectName\\module2
    └── @ohos/lib3 1.0.0