使用local-web-server启动Node服务器时出现CLI模块路径导出未定义错误

这个错误本质是Node的ES模块导出规则导致的：local-web-server试图导入lws包的./lib/cli-app.mjs路径，但这个路径并没有在lws的package.json的exports字段中声明，所以Node抛出了这个错误。

至于为什么相同配置在不同机器上表现不同，大概率是以下几个变量不一致导致的，咱们一步步排查解决：

可能的原因&解决方案 #

1. Node版本差异 #

Node对package.json的exports字段的支持是从v12.16.0开始的，而且不同版本对导出路径的校验严格程度不一样。如果你的当前机器Node版本比另一台旧，就可能触发这个问题：

• 先在两台机器上分别运行node -v对比版本；
• 如果版本不一致，建议把当前机器的Node升级到LTS稳定版（比如v18.x或v20.x），或者降级到和另一台机器相同的版本。

2. 依赖版本不匹配 #

如果你的package.json里没有锁定local-web-server和lws的具体版本，不同机器安装时可能拉取了不同版本的依赖，导致兼容性问题：

• 先去另一台能正常运行的机器上，查看node_modules/lws/package.json里的version字段，记下来；
• 在当前项目的package.json中手动指定这个版本，比如：

  "dependencies": {
    // 其他依赖...
    "lws": "2.2.0" // 替换成你查到的版本号
  }
  

• 然后删除yarn.lock和node_modules，重新运行yarn install；
• 也可以直接锁定local-web-server的版本，确保它和lws版本兼容：yarn add local-web-server@x.x.x（x.x.x是另一台机器的版本）

3. Yarn缓存或安装残留问题 #

有时候Yarn的缓存会导致依赖安装异常，试试清理缓存重新安装：

yarn cache clean
rm -rf node_modules yarn.lock
yarn install

4. 尝试切换包管理器 #

偶尔包管理器的差异也会导致依赖结构不同，试试用npm替代yarn安装：

rm -rf node_modules yarn.lock package-lock.json
npm install
npm start

总结 #

不同机器的差异核心在于Node版本和依赖版本的不一致，只要把这两个变量对齐，问题应该就能解决。

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