Getting Started

故障排查

使用 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
Copyright © 2026