用途:在 Nx monorepo 中调用 Nx 生成器来创建项目(应用、库)、脚手架功能或样板代码、运行工作区自定义生成器,以及完成其他已有生成器覆盖的自动化任务。
主要能力与原则:始终加 --no-interactive 避免交互提示挂起;不能只看 schema,要阅读生成器源码以了解实际创建/修改的文件、副作用与选项交互;生成前研究仓库中相似产物,遵循其命名、目录、测试与构建约定;生成后必须通过 lint/test/build/typecheck 等验证。
使用方式:先用 npx nx list 或 npx nx list @nx/react 发现可用生成器(含插件与本地工作区生成器);用 npx nx g @nx/react:library --help 查看选项;本地生成器优先于外部插件生成器。查找插件生成器源码可用 node -e "console.log(require.resolve('@nx/<plugin>/generators.json'));",失败则读 node_modules/<plugin>/generators.json;本地生成器通常在 tools/generators/ 或本地插件目录。生成前先 --dry-run 确认文件位置,再执行 nx generate <generator-name> <options> --no-interactive。注意 --directory 应写生成物的完整路径(如 --directory=libs/my-lib),而非父目录。
库可构建性:默认使用不可构建库(直接导出 .ts/.tsx 源码,由消费方打包,配置更少);仅在发布 npm、跨仓库共享或需要稳定缓存命中时使用可构建库(--bundler=vite 或 --bundler=swc)。不确定时应询问用户。
生成后:按需修改生成代码,若替换或删除生成的测试文件,需写有意义的替代测试或移除测试目标,否则 nx test 会失败。格式化可用 nx format --fix,验证可用 nx run-many -t build,lint,test,typecheck(仅为示例,应结合本工作区实际目标与 CI 配置)。验证失败且问题可控时修复,问题广泛时先做明显修复再向用户升级说明。
限制:部分生成器不支持 dry-run(如会安装 npm 包),此时可直接实际运行;若没有合适生成器可停止使用该技能,但需先充分排查所有可用生成器。资料未提供收费、价格、平台与效果信息。