<p>Nx Console 无响应通常因未识别到 Nx 工作区根目录，需确认存在 workspace.json 或 nx.json；右键菜单缺失需检查 project.json 及项目是否被 nx graph 收录；插件与本地 Nx 版本不匹配会导致模块报错；Generator 空白则多因 tsconfig.base.json 缺失或 paths 未配置 @nx/* 别名。</p>
Nx Console 插件装了但没反应？检查 workspace.json 或 nx.json 是否存在
VSCode 里 Nx Console 不生效，八成是它没找到 Nx 工作区根目录。它不靠文件夹名识别，而是认 workspace.json（旧版）或 nx.json（v15+）这两个配置文件。如果项目是用 npx create-nx-workspace 初始化的，通常都有；但如果是手动迁入或从 Angular CLI 升级来的，可能只有 angular.json，这时候 Nx Console 就会静默失效。
- 打开 VSCode 终端，运行
npx nx report，看输出里是否列出 projects 和 workspace layout - 确认根目录下存在
nx.json；若不存在，且项目实际是 Nx 管理的，可尝试运行npx nx migrate latest触发自动补全 - 如果用了 pnpm +
pnpm workspace而非 Nx 原生管理，Nx Console 无法识别——它只响应 Nx 自己的 project graph
右键菜单里没有 “Run” 或 “Build”？确认项目已注册进 Nx graph
Nx Console 的上下文菜单项（比如 Run、Test、Serve）不是对任意文件都出现，它只在被 Nx 认为是“project root”的目录下激活，也就是该目录下有 project.json（或旧版 angular.json 里的对应 entry），且该 project 已被 npx nx graph 收录。
- 检查目标项目目录下是否有
project.json；没有的话，npx nx generate @nx/workspace:move --project=my-lib --destination=libs/my-lib这类命令会自动生成，但手动建的文件夹不会 - 运行
npx nx list，看输出里是否包含你的项目名；如果不显示，说明 Nx 还没扫描到它 -
project.json中的targets字段必须定义至少一个 target（如build），否则右键菜单不出现对应操作
点击 “Run” 后终端报错 “Cannot find module ‘@nx/workspace’”？插件与本地 Nx 版本不匹配
Nx Console 插件本身不带 Nx 运行时，它调用的是你项目 node_modules 里的 @nrwl/workspace 或 @nx/workspace。当插件版本较新，而本地 Nx 是 v14 或更早，或者反之，就容易因 API 变更导致模块加载失败。
- 查看插件详情页的 “Compatibility” 标签，确认支持的 Nx 版本范围；VSCode 插件市场里当前（2024）主流版本要求 Nx ≥ 15.9
- 运行
cat node_modules/@nx/workspace/package.json | grep version查本地版本，再比对插件文档 - 临时降级插件：在 VSCode 插件面板里点击齿轮 → “Install Another Version…”，选一个标有 “Nx v14.x” 兼容的旧版
生成器（Generator）列表为空？tsconfig.base.json 缺失或路径别名未配置
Nx Console 的 Generator 面板依赖 TypeScript 项目引用和路径映射来发现可用的 generator 包（比如 @nx/react、@nx/angular）。如果 tsconfig.base.json 不存在，或 compilerOptions.paths 没包含 @nx/* 别名，插件就无法解析 generator 模块结构。
- 检查根目录是否存在
tsconfig.base.json；若无，运行npx nx g @nx/workspace:setup-tsc补上 - 确认
tsconfig.base.json中compilerOptions.paths至少包含"@nx/*": ["./node_modules/@nx/*"] - 重启 VSCode（不是重载窗口），因为 Nx Console 在启动时读取一次 tsconfig，后续修改不热更新
npx nx graph --file=graph.html，能打开图谱，Console 基本就能动起来。 
