Next.js 15 中使用 nuqs 2.0.0 版本时找不到 next/navigation 模块的解决方案

在 Next.js 15 项目中升级到 nuqs 2.0.0 版本时，开发者可能会遇到一个常见的模块导入错误。这个错误表现为系统无法找到 next/navigation 模块，并提示开发者是否应该导入 next/navigation.js 文件。

这个问题的根源在于 Next.js 15 对模块解析机制的一些调整。在 Next.js 15 中，ES 模块的导入路径需要更加明确，包括文件扩展名。而 nuqs 2.0.0 版本在构建时生成的代码中，对 next/navigation 的导入没有包含 .js 扩展名，这导致了模块解析失败。

对于使用 Pages Router 的 Next.js 项目，当安装 nuqs 2.0.0 并尝试运行时，控制台会显示类似以下的错误信息：

Error: Cannot find module '/path/to/node_modules/next/navigation' imported from /path/to/node_modules/nuqs/dist/chunk-YYVIPTKH.js
Did you mean to import next/navigation.js?

开发团队很快确认了这个问题，并在 2.0.1 版本中修复了它。修复方案很简单：在构建过程中确保为 next/navigation 导入添加了正确的 .js 扩展名。对于遇到此问题的开发者，可以采取以下解决方案：

1. 升级到 nuqs 2.0.1 或更高版本
2. 如果暂时无法升级，可以手动编辑 node_modules 中的相关文件，为导入路径添加 .js 扩展名
3. 使用 patch-package 工具创建永久性补丁

值得注意的是，类似的问题在后续版本（如 2.3.2）中可能再次出现，特别是当使用路由无关适配器时。这表明模块解析问题在跨不同 Next.js 版本和配置时可能是一个持续存在的挑战。

对于长期项目维护，建议开发者：

• 保持依赖项更新到最新稳定版本
• 考虑使用 patch-package 等工具管理临时修复
• 关注官方发布说明以获取兼容性更新

这个问题也提醒我们，在 JavaScript 生态系统中，模块解析机制的变化可能会对依赖关系产生连锁反应，特别是在像 Next.js 这样快速发展的框架中。