> AI coding agents: see [/llms.txt](/llms.txt) for the full documentation index. Markdown version: [/docs/manual/zh/getting-started/troubleshooting.md](/docs/manual/zh/getting-started/troubleshooting.md).

---
title: 故障排除
description: 使用 TockDocs 时的常见问题及其解决方案。
navigation:
  icon: i-lucide-wrench
seo:
  description: TockDocs 常见问题及解决方案的故障排除指南。
  title: 故障排除
---

## `pnpm` 相关问题

### 批准构建脚本

如果您在使用 `pnpm` 时遇到构建或开发错误，尤其是与 `better-sqlite3` 依赖相关的错误，您可能需要批准某些包进行构建。

运行以下命令来批准包构建：

```bash [Terminal]
pnpm approve-builds
```

出现提示时，从列表中选择 `better-sqlite3` 和 `sharp` 以批准它们进行构建。

### 启用 shameful hoisting（兼容模式）

如果您遇到诸如 `Can't resolve 'tailwindcss'` 或 `Can't resolve '@nuxt/ui'` 的错误，您不一定需要导入它们，只需应用扁平的 `node_modules` 布局（如 npm 或 yarn）即可。

您可以通过创建包含以下内容的 `.npmrc` 文件来启用兼容模式：

```bash [.npmrc]
shamefully-hoist=true
```