使用npx create-next-app --ts创建Next.js项目时遇env配置替换错误

架构老林

2026-8-15

问题分析：Next.js项目构建报错Failed to replace env in config: ${NODE_AUTH_TOKEN}

以下是几个可能的原因及排查方向：

全局.npmrc文件存在未解析的环境变量引用
npm会读取全局配置文件而非仅项目根目录的.npmrc，全局文件路径：
- macOS/Linux: ~/.npmrc
- Windows: C:\Users\<你的用户名>\.npmrc
  检查该文件中是否包含类似//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}的配置——这种写法会让npm尝试替换环境变量，若变量未正确加载就会触发报错。
环境变量未在当前终端会话生效
即便你在.bash_profile中定义了NODE_AUTH_TOKEN，若修改配置后未重新加载或重启终端，变量可能并未注入当前会话。在终端执行echo $NODE_AUTH_TOKEN，若输出为空，说明变量未生效，可执行source ~/.bash_profile重新加载配置，或重启终端后再尝试创建项目。
npx的环境隔离导致变量无法读取
npx在运行时可能处于隔离的环境中，无法直接读取用户shell的环境变量。可以尝试将变量临时注入到命令上下文：
```
NODE_AUTH_TOKEN=$NODE_AUTH_TOKEN npx create-next-app --ts
```
先确认变量存在后再执行创建操作。