nx console 插件必须在 monorepo 根目录下才生效，因其仅识别根目录下的 nx.json 或 workspace.json；若打开子目录（如 /my-monorepo/libs/ui），插件无法定位工作区，导致命令不可见或提示“no workspace found”，且所有 nx 命令（如 nx serve）也须在根目录执行，project name 必须与 project.json 中的 name 字段严格一致。
Nx Console 插件必须在 monorepo 根目录下才生效，不是打开任意子文件夹就能用
为什么 Nx Console 在 VSCode 里搜不到命令或显示“no workspace found”
插件只认 nx.json 或旧版 workspace.json 文件，并且该文件必须位于 VSCode 当前打开的最外层文件夹中。如果你打开的是 /my-monorepo/libs/ui 或 /my-monorepo/apps/dashboard，插件就完全找不到工作区。
- 确认 VSCode 左下角显示的路径是包含
nx.json的根目录（比如/my-monorepo） - 如果已打开子目录，直接执行命令面板里的
Developer: Reload Window不起作用——必须关掉窗口，重新用“文件 → 打开文件夹”选中根目录再打开 - 检查
nx.json是否被.gitignore误删、或被某些清理脚本移走；文件名大小写也要对（Windows 不敏感，Linux/macOS 敏感）
nx run / nx serve 报 “Project not found” 或 “Target not found” 怎么办
错误根源几乎全是路径和 project name 不匹配：Nx CLI 不看当前终端所在子目录，只依赖 nx.json 中定义的 projects 键，以及各 project.json 文件里的 name 字段。
- 所有
nx命令（包括nx serve my-app）必须在 monorepo 根目录下运行，VSCode 内置终端默认就是这个路径，别手动cd libs/auth再敲命令 -
my-app是 project name，不是文件夹名——它来自apps/my-app/project.json里的"name": "my-app"，大小写、连字符、下划线都必须一字不差 - 刚用
nx g @nx/react:app my-app生成后立刻nx serve my-app失败？先打开apps/my-app/project.json，确认里面有"serve"这个 target；有些 generator 默认不加，得手动补或重跑带--frontend-project参数
Nx Console 点“Run Target”卡住或没反应
这不是 UI 问题，而是背后调用的 nx CLI 启动失败。Nx Console 本身不带 runtime，它只是个图形壳，全靠本地 nx 命令支撑。
- 先在 VSCode 终端里手动运行
npx nx --version：如果报command not found或Cannot find module，说明全局没装nx，而 Nx Console 默认不走npx—— 进设置搜Nx: Use Npx For Nx Commands，勾上它 - Windows 用户用 Git Bash / PowerShell 时容易超时，尤其 WSL 混合环境；可临时改用 VSCode 自带的 CMD 或 Windows Terminal
- 改过
nx.json新增 project 或 target 后，Nx Console 不会自动刷新列表，必须手动执行Developer: Reload Window
TS 类型不更新、跳转错乱、IntelliSense 失效
Nx 项目里 TypeScript Server（TSServer）不会自动感知跨 project 的引用变更，尤其当你新增了 libs/shared-utils 并在 apps/web 里 import 之后。
- VSCode 右下角状态栏点 TS 版本号，选
Restart TS Server—— 这是最常见也最有效的修复动作 - 确保各 project 的
tsconfig.json正确 extends 根目录的tsconfig.base.json，且compilerOptions.paths配置没被覆盖 - 如果用了
project.json里的implicitDependencies或targets.dependencies，修改后也建议重启 TSServer，否则类型推导可能滞后一拍
真正麻烦的从来不是配置步骤，而是那些“看起来应该自动生效，其实要手动触发”的环节：插件重载、TS Server 重启、CLI 路径校验——它们不报错，但功能就卡在半路。
