> ## Documentation Index
> Fetch the complete documentation index at: https://hyperlocalise.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见错误

> 排查常见的安装、配置、提供程序和同步失败问题。

## `i18n.yml already exists; use --force to overwrite`

原因：在配置已存在的情况下运行`init`。

修复：

```bash theme={null}
hyperlocalise init --force
```

## `storage config is required`

原因：在没有顶级 `sync` 配置的情况下使用了 `storage` 命令。

修复：在`i18n.yml`中添加`storage.adapter`和`storage.config`。

## `unsupported output format`

原因：值 `--output` 错误。

修复项：

* `status`：仅`csv`
* `sync`：`text`或`json`

## `unsupported file extension` 在 `run` 期间

原因：映射的源文件或目标文件使用了本地解析器不支持的扩展名。

修复：

* 使用以下之一：`.json`、`.jsonc`、`.yaml`、`.yml`、`.js`、`.jsx`、`.mjs`、`.cjs`、`.ts`、`.tsx`、`.mts`、`.cts`、`.properties`、`.xml`、`.resx`、`.arb`、`.xlf`、`.xlif`、`.xliff`、`.po`、`.html`、`.liquid`、`.md`、`.mdx`、`.strings`、`.stringsdict`、`.xcstrings`、`.csv`、`.ftl`
* 使用以下之一：`.json`、`.jsonc`、`.yaml`、`.yml`、`.properties`、`.xml`、`.resx`、`.arb`、`.xlf`、`.xlif`、`.xliff`、`.po`、`.html`、`.liquid`、`.md`、`.mdx`、`.strings`、`.stringsdict`、`.xcstrings`、`.csv`、`.ftl`

对于 `.xcstrings`，请确保目录具有一个 `strings` 对象，并且要么为变体/替换条目提供源语言本地化，要么提供可用作源文本的简单目录键。

## 提供者身份验证失败

原因：缺少/无效的环境令牌。

修复：在同一个 shell 会话中重新导出令牌，然后重新运行。