根本原因是插件未加载到nx工作区上下文——仅当打开合法nx根目录（含nx.json或workspace.json）时才激活；若打开子目录或配置被files.exclude隐藏，插件即静默失效。
为什么Nx Console在VSCode里不显示项目图谱
根本原因是插件没加载到 Nx 工作区上下文——它只在你打开的是合法 Nx 根目录（含 nx.json 或 workspace.json）时才激活。如果你打开的是 apps/web 子目录，或路径被 files.exclude 隐藏，Nx Console 就完全静默。
检查方式：打开命令面板（Cmd+Shift+P），输入 Nx: Show Project Graph。如果命令不存在，说明插件未识别到 Nx 配置；如果存在但报错 No project graph found，大概率是 nx.json 缺失、格式错误，或当前工作区没启用 Nx 插件（右下角状态栏无 Nx 图标）。
- 确保根目录存在
nx.json（Nx 17+）或workspace.json（旧版），且内容合法（至少有{"version": "17.0.0"}这类基础字段） - 不要用
.gitignore或 VSCode 的files.exclude隐藏nx.json，否则插件读不到 - 安装后必须重启 VSCode，不是重载窗口——插件注册发生在启动阶段
点击“Run Task”却执行失败：cwd 和依赖路径错位
Nx Console 的任务按钮默认在当前文件所在目录启动 shell，而 Nx 命令必须从工作区根运行，否则会找不到 project.json、解析不出依赖拓扑，甚至报 Cannot find module '@nrwl/workspace'。
这不是插件 bug，是 VSCode 任务机制的固有行为。Nx Console 生成的 task 定义里若没显式指定 cwd，就会继承当前编辑器焦点位置。
- 手动编辑
.vscode/tasks.json，为每个 Nx task 加上"options": { "cwd": "${workspaceFolder}" } - 或者直接在 Nx Console 界面右键任务 → “Run in Terminal”，它会自动切到根目录再执行
- 避免在子包里双击运行
build—— 即使该包有project.json，Nx 也需要根目录的配置来校验依赖链
Project Graph 页面空白或加载超时
浏览器中打开的 Nx 图谱页面（http://localhost:4211）依赖本地 npx nx graph 启动的服务进程。VSCode 插件只是个触发器，真正干活的是 CLI。页面空白 ≠ 插件失效，而是 CLI 执行卡住了。
常见阻塞点：TS 类型检查未就绪、tsconfig.base.json 缺失 references、某个 project.json 里 sourceRoot 路径写错导致解析失败。
- 先在终端手动跑
npx nx graph --watch，看是否输出Graph generated或卡在某一步 - 如果报
Cannot resolve type reference，检查所有project.json的sourceRoot是否指向真实存在的目录，且该目录下有tsconfig.json - 图谱服务默认监听
localhost:4211，若端口被占，CLI 会 fallback 到其他端口但不提示——此时需手动访问新地址，或改nx.json中的"tasksRunnerOptions"配置
插件推荐的扩展和设置为什么没生效
Nx Console 会在首次检测到 Nx 工作区时，弹窗推荐 ESLint、Prettier、TypeScript 插件及 workspace settings。但这些只是“建议”，不会自动写入 .vscode/extensions.json 或 .vscode/settings.json。
尤其当你的工作区已存在 .code-workspace 文件，且里面定义了 extensions 字段，Nx Console 的推荐会被完全忽略——VSCode 只认第一个根目录的 extensions.json，其余根目录的扩展配置必须手动维护。
- 别依赖弹窗推荐，直接去
.vscode/extensions.json手动加：{"recommendations": ["nrwl.angular", "esbenp.prettier-vscode"]} - workspace-level 设置（如
eslint.workingDirectories）必须写在.code-workspace的settings字段里，而不是某个子目录下的settings.json - 如果用了多根工作区（多个
folders），Nx Console 只对第一个根生效；想让它管理全部，得把所有子项目都删掉，只留根目录一个文件夹
tsconfig.json 的 references 和 paths 配置是否正确，以及你有没有手动重启 TS Server。
