开始使用

故障排除

使用 Docus 时的常见问题及其解决方案。

pnpm 问题

批准构建脚本

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

运行以下命令批准包进行构建:

Terminal
pnpm approve-builds

出现提示时,从包列表中选择 better-sqlite3sharp 以批准它们进行构建。

启用 shameful hoisting(兼容模式)

如果您看到诸如 Can't resolve 'tailwindcss'Can't resolve '@nuxt/ui' 之类的错误,您不一定需要导入它们,您只需应用扁平的 node_modules 布局(如 npm 或 yarn)。

您可以通过创建一个 .npmrc 文件来启用兼容模式:

.npmrc
shamefully-hoist=true
© 2026 TATEN. All rights reserved.