用途:面向 Nx monorepo 工作区的配置、探索与优化,适合搭建 Nx、了解工作区结构、划分项目边界及分析受影响项目。
主要能力:列举与筛选项目,如 nx show projects、nx show projects --type app、nx show projects --projects "apps/*"、nx show projects --withTarget build;受影响分析,如 nx show projects --affected --base=main、nx affected -t test --base=main;运行任务,如 nx build web --configuration=production;查看依赖图,nx graph。工作区结构为 apps/ 可部署应用、libs/ 共享库(含 shared 与 feature)、nx.json 配置、tools/ 自定义执行器与生成器。库类型包括 feature、ui、data-access、util。
使用方式:查询项目完整配置须用 nx show project <name> --json,而不要直接读 project.json(其仅含部分配置),可配合 jq 提取 targets。若 nx 未全局安装,命令前加 npx、pnpx 或 yarn。配置 schema 位于 node_modules/nx/schemas/nx-schema.json 与 project-schema.json。
限制与排错:targets 不显示时改用 nx show project <name> --json;affected 失效需保证 git 历史可用,CI 中设 fetch-depth: 0;缓存问题可执行 nx reset。详细配置、命令、CI/CD 与最佳实践见 reference 目录下对应文档。