用户目录含非ASCII字符ø导致React包构建出现Cannot find module错误

问题核心 #

用户目录名称中的ø字符在构建过程中被错误转码为乱码├╕，导致Node.js无法定位正确的Yarn模块路径。仅React包出现异常，说明该包的构建脚本或依赖工具在路径解析时的编码处理逻辑与其他包存在差异。

可行解决方案（按风险从低到高排序） #

1. 临时切换到无特殊字符目录构建 #

• 将整个monorepo复制到路径全为ASCII字符的目录（比如C:\temp\your-monorepo）
• 在新目录下执行yarn install和React包的构建命令
• 此方法可快速验证问题是否由用户目录特殊字符导致，无系统级风险

2. 强制终端UTF-8编码并升级依赖工具 #

• 打开命令提示符，先执行编码切换命令：

  chcp 65001
  

• 进入React包目录重新执行构建命令
• 升级Yarn到最新版本（推荐Yarn Berry），新版本对非ASCII路径支持更完善：

  yarn set version berry
  yarn install
  yarn build
  

3. 迁移全局Node.js依赖到无特殊字符路径 #

• 修改npm全局安装路径，避开用户目录：

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

• 将C:\node_global添加到系统环境变量的Path中
• 重新全局安装Yarn：

  npm install -g yarn
  

• 之后重新构建React包，此时Yarn会从新的全局路径加载，避免特殊字符路径问题

4. 重命名用户目录（高风险） #

• 此方案会影响所有依赖原用户目录的软件，需谨慎操作：
  • 创建新的无特殊字符用户账户（如LarsMoster）
  • 迁移原用户目录下的所有文件到新账户目录
  • 手动修复系统和第三方软件中指向原用户目录的配置项
  • 使用新账户登录后重新克隆并构建项目

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