Nx 升级至 16.7.4 后 nx show projects 返回空白，通常并非缓存或版本兼容性问题，而是因全局或项目级忽略文件（如 .ignore）意外屏蔽了 project.json 或 package.json，导致 Nx 无法扫描到项目定义。
nx 升级至 16.7.4 后 `nx show projects` 返回空白，通常并非缓存或版本兼容性问题，而是因全局或项目级忽略文件（如 `.ignore`）意外屏蔽了 `project.json` 或 `package.json`，导致 nx 无法扫描到项目定义。
Nx 自 v16.6.0 起显著加强了对文件系统忽略规则的尊重——不仅读取项目根目录下的 .gitignore 和 .nxignore，还会主动识别并应用本地常见的忽略配置文件（如 .ignore、.rgignore 等），且优先级可能高于预期。一旦这些文件中包含类似 *.json、project.json 或 package.json 的条目，Nx 将跳过所有匹配的 JSON 配置文件，从而完全“看不见”你的应用（apps）和库（libs），即使它们物理存在且结构正确。
? 快速诊断步骤
请按顺序检查以下路径中的 所有忽略文件，重点关注是否包含 JSON 相关的排除规则：
- 项目根目录：.gitignore、.nxignore、.ignore、.rgignore、.fdignore
- 用户主目录（尤其 macOS）：~/.ignore、~/.gitignore_global
- 全局工具生成的隐藏配置（常见于 JetBrains IDE、VS Code 插件、ripgrep、fd 等）
执行以下命令快速筛查：
# 检查项目内所有忽略文件是否含 project.json 或 *.json grep -r -i "project.json|.json" . --include=".*ignore*" 2>/dev/null # 检查用户主目录 grep -i "project.json|.json" ~/.ignore ~/.gitignore_global 2>/dev/null✅ 解决方案
移除或注释掉引发问题的行。例如，若发现 ~/.ignore 中有：
# IntelliJ/Solargraph auto-generated? *.json请将其修改为更精确的排除（推荐）：
# 仅忽略构建产物或临时 JSON，保留项目配置 dist/**/*.json coverage/**/*.json或直接删除该行。
⚠️ 注意：*.json 是高危通配符——它会阻止 Nx 读取 project.json（必需）、workspace.json/nx.json（核心）、package.json（影响插件检测与依赖解析）。Nx 16.6+ 对此行为更严格，因此旧版（如 15.x）无异常，而新版直接静默跳过。
? 验证修复
清理缓存后重新探测：
# 清理 Nx 缓存（必要）nx reset # 可选：清除 Yarn 缓存（非必须，但可排除干扰）yarn cache clean # 验证项目是否可见 nx show projects --all # --all 显示所有（含隐式项目）若输出正常，说明问题已定位并解决；若仍为空，请运行调试命令进一步确认文件扫描路径：
nx show projects --verbose其输出中会显示 Nx 实际遍历的目录及跳过的文件原因（例如 Ignored by ignore file: /path/project.json），这是最权威的诊断依据。
? 总结
- 根本原因：Nx 16.6+ 强化忽略逻辑，全局 .ignore 类文件中的宽泛规则（如 *.json）会阻断项目发现。
- 关键动作：检查 ~/.ignore 等用户级忽略文件——M1 Mac 上由 IntelliJ、Solargraph 或 CLI 工具自动生成的概率极高。
- 最佳实践：避免在忽略文件中使用 *.json；应显式排除具体路径（如 dist/**/*），而非扩展名层面一刀切。
升级 Nx 后遇到“项目消失”，请先 grep -r “project.json” ~ . ——90% 的案例，答案就藏在某个你从未注意过的 .ignore 文件里。
