1. 安装时遇到网络问题或镜像源配置错误怎么办如果你在国内使用时遇到下载速度慢、连接超时或因配置了错误的下载源导致文件下载失败、下载内容不完整/不正确建议切换 npm 下载源方式一使用 npm 官方源npm config set registry https://registry.npmjs.org/方式二使用淘宝镜像源npm config set registry https://registry.npmmirror.com/设置完成后建议先清除缓存再重新安装npm cache clean --forcenpm install可通过 npm config get registry 查看当前配置的下载源。2. 免费模型有使用限制吗登录后默认提供免费的 GLM-5.1 模型单账号存在额度限制。免费模型适合快速体验但在复杂场景下可能存在能力局限。为获得最佳体验推荐配置第三方模型如 智谱、通义千问、DeepSeek 等在 DevEco Code 中按 CtrlA 进入 Provider 选择界面或在 deveco.jsonc 中配置 Provider详见 模型配置3. 编译构建或推包运行时报错怎么办编译构建、推包、模拟器运行等能力依赖 DevEco Studio请确认已安装 DevEco Studio 6.1 及以上版本已正确配置 DEVECO_HOME 环境变量macOSexport DEVECO_HOME/Applications/DevEco-Studio.appWindows在系统环境变量中添加 DEVECO_HOME值为 DevEco Studio 安装路径如 C:\Program Files\Huawei\DevEco Studio配置完成后可在终端验证# macOSecho $DEVECO_HOME# Windows PowerShellecho $env:DEVECO_HOME4. 登录华为账号失败或提示认证错误怎么办DevEco Code 需要通过华为账号登录后才能使用。如果登录失败请检查网络连接是否正常登录需要访问华为账号服务终端是否能正常访问外网如果使用了代理尝试关闭代理后重试如需重新登录可先登出再登录deveco auth logoutdeveco auth login5. 修改了 MCP / Skill / Plugin 配置后没有生效新增或修改 Skill、MCP、Plugin 配置后需要退出并重新启动 DevEco Code 才会生效在终端中按 CtrlC 退出当前会话重新执行 deveco 启动6. 推包真机时提示签名失败或未签名怎么办DevEco Code 当前不支持直接进行应用签名。如需将应用推送到真机运行请按以下步骤操作在 DevEco Studio 中打开项目完成应用签名配置与签名操作签名完成后回到 DevEco Code 重新执行推包命令将应用部署到真机应用签名涉及证书与 Profile 文件的管理这些能力目前仅在 DevEco Studio 中提供。后续版本可能会在 DevEco Code 中集成签名支持。DevEco Code - An open-source AI Agent for HarmonyOS applcation development.
HarmonyOS掌上记账APP开发实践第83篇：DevEco Code AI Agent工具常见FAQ
1. 安装时遇到网络问题或镜像源配置错误怎么办如果你在国内使用时遇到下载速度慢、连接超时或因配置了错误的下载源导致文件下载失败、下载内容不完整/不正确建议切换 npm 下载源方式一使用 npm 官方源npm config set registry https://registry.npmjs.org/方式二使用淘宝镜像源npm config set registry https://registry.npmmirror.com/设置完成后建议先清除缓存再重新安装npm cache clean --forcenpm install可通过 npm config get registry 查看当前配置的下载源。2. 免费模型有使用限制吗登录后默认提供免费的 GLM-5.1 模型单账号存在额度限制。免费模型适合快速体验但在复杂场景下可能存在能力局限。为获得最佳体验推荐配置第三方模型如 智谱、通义千问、DeepSeek 等在 DevEco Code 中按 CtrlA 进入 Provider 选择界面或在 deveco.jsonc 中配置 Provider详见 模型配置3. 编译构建或推包运行时报错怎么办编译构建、推包、模拟器运行等能力依赖 DevEco Studio请确认已安装 DevEco Studio 6.1 及以上版本已正确配置 DEVECO_HOME 环境变量macOSexport DEVECO_HOME/Applications/DevEco-Studio.appWindows在系统环境变量中添加 DEVECO_HOME值为 DevEco Studio 安装路径如 C:\Program Files\Huawei\DevEco Studio配置完成后可在终端验证# macOSecho $DEVECO_HOME# Windows PowerShellecho $env:DEVECO_HOME4. 登录华为账号失败或提示认证错误怎么办DevEco Code 需要通过华为账号登录后才能使用。如果登录失败请检查网络连接是否正常登录需要访问华为账号服务终端是否能正常访问外网如果使用了代理尝试关闭代理后重试如需重新登录可先登出再登录deveco auth logoutdeveco auth login5. 修改了 MCP / Skill / Plugin 配置后没有生效新增或修改 Skill、MCP、Plugin 配置后需要退出并重新启动 DevEco Code 才会生效在终端中按 CtrlC 退出当前会话重新执行 deveco 启动6. 推包真机时提示签名失败或未签名怎么办DevEco Code 当前不支持直接进行应用签名。如需将应用推送到真机运行请按以下步骤操作在 DevEco Studio 中打开项目完成应用签名配置与签名操作签名完成后回到 DevEco Code 重新执行推包命令将应用部署到真机应用签名涉及证书与 Profile 文件的管理这些能力目前仅在 DevEco Studio 中提供。后续版本可能会在 DevEco Code 中集成签名支持。DevEco Code - An open-source AI Agent for HarmonyOS applcation development.
