1. 安装时遇到网络问题或镜像源配置错误怎么办？
如果你在国内使用时遇到下载速度慢、连接超时，或因配置了错误的下载源导致文件下载失败、下载内容不完整/不正确，建议切换 npm 下载源：

方式一：使用 npm 官方源

npm config set registry https://registry.npmjs.org/

方式二：使用淘宝镜像源

npm config set registry https://registry.npmmirror.com/

设置完成后，建议先清除缓存再重新安装：

npm cache clean --force
npm install

可通过 npm config get registry 查看当前配置的下载源。

2. 免费模型有使用限制吗？
登录后默认提供免费的 GLM-5.1 模型，单账号存在额度限制。

免费模型适合快速体验，但在复杂场景下可能存在能力局限。为获得最佳体验，推荐配置第三方模型（如 智谱、通义千问、DeepSeek 等）：

在 DevEco Code 中按 Ctrl+A 进入 Provider 选择界面
或在 deveco.jsonc 中配置 Provider，详见 模型配置
3. 编译构建或推包运行时报错怎么办？
编译构建、推包、模拟器运行等能力依赖 DevEco Studio，请确认：

已安装 DevEco Studio 6.1 及以上版本
已正确配置 DEVECO_HOME 环境变量：
macOS：export DEVECO_HOME=/Applications/DevEco-Studio.app
Windows：在系统环境变量中添加 DEVECO_HOME，值为 DevEco Studio 安装路径（如 C:\Program Files\Huawei\DevEco Studio）
配置完成后可在终端验证：

# macOS
echo $DEVECO_HOME

# Windows PowerShell
echo $env:DEVECO_HOME

4. 登录华为账号失败或提示认证错误怎么办？
DevEco Code 需要通过华为账号登录后才能使用。如果登录失败，请检查：

网络连接是否正常（登录需要访问华为账号服务）
终端是否能正常访问外网
如果使用了代理，尝试关闭代理后重试
如需重新登录，可先登出再登录：

deveco auth logout
deveco auth login

5. 修改了 MCP / Skill / Plugin 配置后没有生效？
新增或修改 Skill、MCP、Plugin 配置后，需要退出并重新启动 DevEco Code 才会生效：

在终端中按 Ctrl+C 退出当前会话
重新执行 deveco 启动
6. 推包真机时提示签名失败或未签名怎么办？
DevEco Code 当前不支持直接进行应用签名。如需将应用推送到真机运行，请按以下步骤操作：

在 DevEco Studio 中打开项目，完成应用签名配置与签名操作
签名完成后，回到 DevEco Code 重新执行推包命令将应用部署到真机
应用签名涉及证书与 Profile 文件的管理，这些能力目前仅在 DevEco Studio 中提供。后续版本可能会在 DevEco Code 中集成签名支持。

DevEco Code - An open-source AI Agent for HarmonyOS applcation development.