一、背景
由于我在项目中使用parameterFile配置了参数化文件，来指定依赖版本信息，导致我直接使用ohpm install <包名> 引入依赖时报错(这种操作其实是错误的，下面有详细讲)
原因为：当项目级 oh-package.json5 文件中存在“parameterFile”配置时，无法执行“ohpm install <pkg>”命令
二、parameterFile 是什么？
详细可查看官网链接：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-oh-package-json5#section122411462820
2.1、parameterFile介绍
来源官网：OHPM新增了参数化配置功能。开发者可在项目根目录配置一个参数化文件（json5格式文件），在该文件中维护模块或依赖版本信息，不同模块将根据该文件中的版本进行配置，满足不同构建场景下，开发者快速切换依赖版本的需要。同时，支持通过命令行指定参数化文件，降低流水线场景下模块和依赖版本的变更难度。
2.2、parameterFile作用
是集中管理依赖的版本参数（比如把版本号定义在单独的参数文件里，依赖通过 @param:版本参数名 引用），但它并不强制所有依赖都必须用参数引用：
我直接在 dependencies 里写具体版本（比如 "@xx/bh_log_tool": "^1.0.0-alpha.1"），属于显式指定版本，符合 ohpm 的依赖解析规则；
而 ohpm install <包名> 会自动写入版本到dependencies，但因为 parameterFile 的存在，ohpm 会拦截这个 “自动写版本” 的操作，防止破坏参数化版本管理的规范。
三、两种模式操作逻辑
3.1、parameterFile 模式
步骤1：创建工程级版本参数文件
比如项目根目录新建 parameterFile.json5（参数文件），集中维护所有的依赖版本：
步骤 2：配置工程级 oh-package.json5（根目录）
在根目录的oh-package.json5中，指定parameterFile路径（关联步骤 1 的参数文件）：
步骤 3：配置模块级 oh-package.json5（如 entry 模块）
在需要使用依赖的模块（如entry/oh-package.json5）中，通过@param:参数名引用工程级参数文件的版本(需要手动写入依赖)：
步骤 4：执行全量安装命令
在项目根目录执行：即可下载新增依赖
ohpm install此时 ohpm 会：
读取 parameterFile 中的版本参数；解析 dependencies 中的依赖声明；下载对应版本的 @xxx/bh_log_tool 到项目中，并生成 oh_modules。
3.2、无 parameterFile 模式
//安装指定版本 ohpm install @xxx/bh_log_tool@1.0.0-alpha.1四、两种方式总结
场景 | 是否能执行ohpm install <包名> | 是否需要手动写dependencies | 最终安装命令 |
无 parameterFile | ✅ 可以 | ❌ 不需要（自动写入） | ohpm install <包名> |
有 parameterFile | ❌ 禁止 | ✅ 需要（声明依赖） | ohpm install（全量） |
