Ubuntu系统下通过Wine运行Node v16出现Z盘lstat报错问题求助

问题根因 #

Node v12及之后版本重构了fs.realpathSync的Windows路径校验逻辑，会强制校验目标路径所在盘符的卷元数据。Wine默认的Z盘是直接映射Linux根目录的虚拟盘符，没有标准Windows盘符的卷标识，Node16调用lstat读取Z盘根目录信息时就会抛出EINVAL错误。

可行解决方案 #

• 方案1：调整Wine盘符映射（最稳定）
  打开Wine配置工具winecfg，切换到「驱动器」标签页，点击「添加」选择一个未占用的盘符（如Y:），将路径指向你存放Node项目的Linux本地目录，再点击「高级」按钮，将盘符类型设置为「硬盘」，保存配置后在新挂载的盘符下运行node、npm命令即可。
• 方案2：添加Node启动参数绕过校验
  运行node脚本时添加--preserve-symlinks、--preserve-symlinks-main参数跳过路径校验，示例：
  node --preserve-symlinks --preserve-symlinks-main Z:\test.js
  npm无法使用的问题可以通过别名指定启动参数解决，将npm命令指向Node安装路径下的npm cli文件并附加参数：
  alias npm='wine node --preserve-symlinks "C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js"'
• 方案3：将项目迁移到Wine C盘
  把所有Node相关的项目、npm全局路径都放到Wine模拟的C盘对应目录下（Linux侧路径一般为~/.wine/drive_c/users/当前用户名/），再执行以下命令配置npm的全局路径和缓存路径到C盘：

  npm config set prefix "C:\\npm\\prefix"
  npm config set cache "C:\\npm\\cache"
  

  提前在C盘创建对应目录即可正常使用node和npm。
• 临时兼容方案
  若不需要Node16的新特性，可以降级到Node v14 LTS版本，该版本对Wine虚拟盘符的兼容性较好，不会触发该报错。

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