Ubuntu运行Nuxt.js报错：找不到/.nuxt/components/plugin.js如何解决

问题原因 #

• 路径特殊字符解析bug：项目存放路径包含[1000]这类方括号特殊字符，Nuxt 2.15.x版本的自动组件扫描功能在Linux环境下对路径特殊字符的解析存在已知缺陷，无法正确定位生成的plugin.js文件，Windows系统的路径处理逻辑对这类特殊字符容错性更高，因此Windows环境运行正常。
• 外接磁盘权限不足：项目存放在外接挂载的Seagate移动硬盘中，Ubuntu默认挂载的外接存储设备通常仅开放只读权限，或者当前用户没有写入权限，导致Nuxt生成.nuxt构建目录时文件写入不完整，缺失plugin.js文件。
• 依赖与缓存不兼容：如果直接从Windows环境复制了node_modules或.nuxt缓存目录，两类系统的依赖二进制包、构建产物不通用，会导致文件读取失败。
• Node版本兼容性问题：Nuxt 2.x对Node高版本（17+）兼容性较差，如果nvm安装的Node版本和Windows环境下使用的版本不一致，也可能引发构建异常。

解决方案 #

1. 优先修复路径问题
   将整个项目目录移动到当前用户的Home目录下（例如~/projects/katusha-nuxt），确保路径不包含方括号、空格、中文等特殊字符，排除路径解析bug。
2. 清理缓存重新安装依赖
   进入项目目录后执行以下命令：

# 删除旧的构建缓存、依赖和锁文件
rm -rf .nuxt node_modules yarn.lock
# 重新安装依赖
yarn install
# 启动开发服务
yarn dev

3. 检查Node版本匹配度
   确认当前nvm激活的Node版本和Windows环境下的版本一致，优先使用Node 14.x或16.x LTS版本，避免版本兼容问题。
4. 外接磁盘权限修复（如果必须存放在移动硬盘）
   重新挂载移动硬盘时给当前用户开放读写执行权限，或修改挂载点的目录权限，确保当前用户对项目目录有完整的读写权限。
5. 兜底规避方案
   如果以上方案都无法解决，可以在nuxt.config.js中关闭自动组件扫描功能，直接规避路径解析问题：

export default {
  // 其他配置保持不变，添加以下行
  components: false
}

关闭后需要手动导入项目中使用的自定义组件。

内容的提问来源于stack exchange，提问作者Sabrina Louge