Nx插件不识别workspace.json或nx.json，需确保VSCode打开的是含该文件的monorepo根目录，并重启窗口；命令须在根目录执行；TS类型更新需手动重启TS Server。
VSCode里Nx插件不识别workspace.json或nx.json怎么办
Nx插件（如“Nx Console”）启动后没反应，或者命令面板里搜不到 nx 相关命令，大概率是它压根没找到你的 Nx 工作区根目录。它只认 nx.json 或 workspace.json（旧版），且必须在 VSCode 打开的最外层文件夹里——不是子项目，不是某个libs目录，是整个 monorepo 的根。
- 确认你用 VSCode 打开的是包含
nx.json的那一级目录，比如/my-monorepo，而不是/my-monorepo/libs/ui - 如果项目是从旧版 Angular CLI + Nx 迁移来的，可能只有
workspace.json，插件默认也支持，但得确保文件没被 .gitignore 误删、也没被编辑器缓存忽略 - 插件不会自动重载配置：改完
nx.json后，要手动执行命令面板里的Developer: Reload Window，否则新增的 project 或 target 不会出现在 Nx Console 列表里
运行 nx run 时提示 “Target not found” 或 “Project not found”
这是最常见的误操作：你在终端里进了某个子项目目录（比如 libs/auth），然后敲 nx run auth:build —— VSCode 终端当前路径不影响 Nx 解析，但它会影响环境变量和 tsconfig 路径解析，更关键的是，Nx 命令必须从 workspace 根下执行，否则它找不到 project 配置。
- 所有
nx命令（包括nx serve、nx test、nx run）都应在 workspace 根目录下运行，VSCode 内置终端默认就是这个路径，别 cd 进去 -
auth:build中的auth是 project name，不是文件夹名；它来自nx.json的projects字段或project.json文件名，大小写和连字符必须完全一致 - 如果项目刚用
nx g @nx/react:app my-app生成，但立刻跑nx serve my-app报错，先检查apps/my-app/project.json是否真有"targets": { "serve": { ... } }，有些 generator 默认不加 serve target
Nx Console 插件里点 “Run Target” 没反应或卡住
表面是 UI 卡顿，实际常是 Nx CLI 启动失败或超时，尤其在 Windows + WSL 混合环境，或 node 版本不兼容时。Nx Console 本质是调用本地 nx CLI，不是独立服务。
- 先在 VSCode 终端手动运行
npx nx --version，确认能输出版本号；如果报command not found或Cannot find module，说明全局没装nx，而 Nx Console 默认不走 npx，得在插件设置里勾选Use npx for nx commands - Windows 用户若用 Git Bash 或 PowerShell，可能因 shell 环境缺失
PATH导致找不到node，建议在 VSCode 设置里指定终端为cmd或PowerShell，并在插件设置中填入完整 node 路径，例如C:\Program Files\nodejs\node.exe - 如果 target 运行几秒后自动退出，没日志，检查
project.json里对应 target 的command或executor是否拼错，比如写成@nrwl/web:dev-server却没安装@nrwl/web包
修改 tsconfig.base.json 后类型提示不更新
Nx monorepo 的类型引用靠 tsconfig.base.json 的 paths 和 references 驱动，但 VSCode 不会自动监听这个文件变化并刷新 TS Server，导致 import 提示“cannot find module”，哪怕 nx build 能过。
- 改完
tsconfig.base.json后，必须在 VSCode 命令面板执行Typescript: Restart TS server，否则编辑器仍用旧的路径映射 -
paths里的别名（如@myorg/ui）必须以*结尾才能匹配子路径，写成"@myorg/ui": ["libs/ui/src/index.ts"]会导致import { x } from "@myorg/ui/lib/button"失败 - 如果用了
references（推荐方式），确保每个project.json里root字段和对应tsconfig.json的位置一致，否则 TS Server 无法定位项目边界
真正卡住人的，往往不是 Nx 本身多难，而是 VSCode 缓存、TS Server 状态、CLI 执行路径这三者之间的隐式耦合——它们不报错，只静默失效。
