TockDocs LogoTockDocs
AI coding agents: see /llms.txt for the full documentation index. Markdown version: /docs/manual/zh/getting-started/troubleshooting.md.
快速入门

故障排除

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

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