如何正确使用Create Next App的离线功能？

官方提到的离线支持依赖包管理器的本地缓存，但默认情况下npx/pnpm在离线时仍会尝试联网检查版本或拉取缺失的依赖，导致报错。以下是具体解决步骤：

一、提前在联网环境下完成缓存 #

在有网络时，先确保create-next-app及其所有依赖被完整缓存到本地：

针对npm/npx #

• 方法1：全局安装一次create-next-app，强制缓存所有依赖：

  npm install -g create-next-app
  

• 方法2：使用--dry-run模拟创建项目，避免生成实际文件但完成缓存：

  npx create-next-app --dry-run
  

针对pnpm #

• 方法1：全局安装缓存：

  pnpm add -g create-next-app
  

• 方法2：模拟创建完成缓存：

  pnpm create next-app --dry-run
  

二、离线环境下的正确命令 #

离线时必须明确告诉包管理器使用本地缓存，禁止联网请求：

npm/npx #

执行命令时添加--offline参数：

npx --offline create-next-app

pnpm #

同样添加--offline参数：

pnpm create next-app --offline

或者通过环境变量强制开启离线模式：

PNPM_OFFLINE=true pnpm create next-app

额外注意事项 #

• 离线时只能使用缓存中已有的create-next-app版本，无法指定未缓存的新版本。
• 可以通过以下命令检查缓存是否存在：
  • npm：npm cache ls create-next-app
  • pnpm：pnpm store ls create-next-app

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