[Documentation|文档反馈]: [AI 识别] QUICKSTART 未说明 ASCEND_CUSTOM_OPP

已关闭

[Documentation|文档反馈]: [AI 识别] QUICKSTART 未说明 ASCEND_CUSTOM_OPP_PATH 环境变量的配置 #697

StoneChan_创建于 8月4日关闭于 8月5日

8月4日创建

Issue 模板: documentation
来源: Scene 1 文档可操作性评估（batch_id: 20260803_103134）
优先级: P1
关联 KEP: operator_debug（KEI: run_success_rate = 0）

Document Link（文档链接）

https://gitcode.com/cann/ops-cv/blob/master/docs/QUICKSTART.md （第 4 节"配置环境变量"，第 76-82 行）

Issues Section（问题文档片段）

### 4. 配置环境变量

将自定义算子包的路径加入环境变量，确保运行时能够找到。

```bash
export LD_LIBRARY_PATH=&#36;{ASCEND_HOME_PATH}/opp/vendors/custom_cv/op_api/lib:&#36;{LD_LIBRARY_PATH}


## Existing Issues（存在的问题）

QUICKSTART 仅配置了 `LD_LIBRARY_PATH`，但未说明是否还需要配置 `ASCEND_CUSTOM_OPP_PATH` 环境变量。在某些 CANN 版本和场景下，运行自定义算子时需要通过 `ASCEND_CUSTOM_OPP_PATH` 指定自定义算子包路径，否则 aclnn API 可能无法找到算子实现。

AddExample 运行失败 error 161001（aclnnAddExampleGetWorkspaceSize failed，见 issue-2）可能与缺少此环境变量有关。

### 建议改进

1. 明确说明在哪些场景下需要配置 `ASCEND_CUSTOM_OPP_PATH`
2. 补充配置命令示例：

   ```bash
   export ASCEND_CUSTOM_OPP_PATH=${ASCEND_HOME_PATH}/opp/vendors/custom_cv:$ASCEND_CUSTOM_OPP_PATH

或说明仅配置 LD_LIBRARY_PATH 即可覆盖所有场景，并说明原因

StoneChan_成员

8月4日添加了label：documentation

M majiajian_hw成员

8月4日将 liu-wei 设为负责人

liu-wei成员

8月4日评论：

感谢反馈。经在本仓环境实测，issue 中的部分说法成立，但核心关联结论有误，具体如下。

"QUICKSTART 只配了 LD_LIBRARY_PATH，未提 ASCEND_CUSTOM_OPP_PATH" —— 属实，但当前写法正确
默认安装路径下，install.sh（scripts/custom/install.sh:310-326）会写入 vendors/config.ini，CANN 运行时据此自动加载 vendors 目录下的算子，不需要额外配置 ASCEND_CUSTOM_OPP_PATH。
实测反证：本环境成功运行 AddExample 时，ASCEND_CUSTOM_OPP_PATH 为空，仅按 QUICKSTART 配置了 LD_LIBRARY_PATH 即可。
"AddExample error 161001 可能与缺少 ASCEND_CUSTOM_OPP_PATH 有关" —— 不成立
已在 #693 中实测复现并定位根因：error 161001 的真正原因是编译时 --soc 与实际硬件 SoC 不匹配，导致算子二进制未加载、nnopExecutor 为空，与 ASCEND_CUSTOM_OPP_PATH 无关。
另外，scripts/build_example.sh:104-108 在未设置 ASCEND_CUSTOM_OPP_PATH 时会回退到默认路径 ${ASCEND_HOME_PATH}/opp/vendors/${VENDOR}_cv/，正好是 QUICKSTART 安装的目标路径，因此默认流程下不会因缺少该变量而失败。
"建议说明哪些场景需要 ASCEND_CUSTOM_OPP_PATH" —— 合理，可采纳
该变量仅在非默认路径场景下需要，建议在文档中补充说明：

使用 --install-path 安装到自定义目录时：install.sh:289-292 会生成 set_env.bash，需执行 source <安装路径>/vendors/custom_cv/bin/set_env.bash 设置该变量。
开发态未安装、直接从 build 目录加载算子时：build_lib.sh:133 会设置该变量指向构建产物路径。
默认安装路径（QUICKSTART 场景）下无需配置，当前文档写法正确。

liu-wei成员

8月5日 issue状态由进行中改变为已完成

liu-wei成员

8月5日关闭了 issue