Getting Started
故障排查
使用 Docus 时常见问题及解决方案。
pnpm 问题
批准构建脚本
如果你在使用 pnpm 时遇到构建或开发错误,尤其是与 better-sqlite3 依赖相关的错误,可能需要批准某些包的构建。
运行以下命令以批准构建包:
Terminal
pnpm approve-builds
当提示时,从列表中选择 better-sqlite3 和 sharp 以便批准它们的构建。
启用兼容模式(shameful hoisting)
如果你看到类似 Can't resolve 'tailwindcss' 或 Can't resolve '@nuxt/ui' 的错误,不一定需要手动导入它们。你可以通过使 node_modules 布局扁平化(类似 npm 或 yarn)来解决。
你可以通过创建一个 .npmrc 文件并添加以下内容来启用兼容模式:
.npmrc
shamefully-hoist=true