<!--
source: https://blueos.niceshare.site/guide/pitfalls/
site: 蓝河文档馆
summary: BlueOS 常见问题，以及黑屏、不更新、不显示等开发排错对照表。
-->
---
title: 常见问题
description: BlueOS 常见问题，以及黑屏、不更新、不显示等开发排错对照表。
---

## FAQ

### 蓝河和 BlueOS 是什么关系？

蓝河是 vivo 面向智能手表等穿戴设备的操作系统，英文名为 BlueOS。两词指同一平台。产品介绍见 [蓝河官网](https://blueos.vivo.com/)。

### 蓝河应用用什么开发？

内核基于 Rust；应用侧采用类 Web 开发范式：用 UI 组件搭页面、用样式描述效果、用 JavaScript 写业务逻辑。应用支持类似 Vue2 的 MVVM，通过数据绑定驱动视图，数据变化时自动更新 UI。页面写在 `.ux` 文件（`script` / `template` / `style`）里，配置写在 `manifest.json`。语法像 Vue，但运行时不是 Vue，也没有 `document` / DOM。

### 新手应该从哪里开始？

先读 [从这里开始](/guide/)，再按顺序完成 [Hello World](/guide/hello-world/) 和 [待办应用](/guide/todo-app/)。查某个组件或 API 的字段时，用侧边栏里的官方参考。

## 开发排错

按「症状 → 原因 → 正确写法」对照。先对症状，再改代码。

**学完能做什么：** 对照表格定位自己的问题。

**前置：** 最好已经做过 [待办应用](/guide/todo-app/)，没有也可以当速查表。

| 症状 | 原因 | 正确写法 |
|------|------|----------|
| 黑屏，日志 `create_function: value is not an object` | 事件绑定里写了 `{{ }}` | `onclick="openDetail(item)"` |
| 改了数据，界面不动 | 字段没进 `data`，或没用 `$set` | `data: { title: '' }` 再 `this.title = 'x'` |
| 改了 `todos[i].done`，列表不刷新 | 嵌套字段可能不触发更新 | `this.todos = next` |
| 屏幕上没有字 | 文案写在 `<div>` 里 | `<text>内容</text>` |
| `router.push` 没反应 | 页面没进 `manifest.router.pages` | 目录名与 pages key 一致 |
| `storage` / `fetch` 失败 | 未声明 `features`，或未处理 `fail` | manifest 声明 + 每个调用带 `fail` |
| 圆角看不见 | 只写了 `border-radius` | 同时设 `border-width` 和 `border-color`（或用四角分开的 radius） |
| 布局错乱、间距没有 | 用了 `gap`、`display: block`、或 Tailwind 放出的 `flex: 1 1 0%` | flex + 子元素 margin；需要时手写 `flex: 1` |
| `for` 顺序反了 | 按 Vue 写成 `(item, index)` | `(index, item)`，下标在前 |

## 本页要点

- 黑屏先查事件里的 `{{ }}`。
- 不更新先查 `data` / 整表赋值。
- API 失败先查 `features` 和 `fail`。

下一篇：[接下来去哪](/guide/next-steps/)