为什么执行npm install react时最新版为17却安装了16版本？

出现该问题通常和本地依赖配置、源同步情况、版本锁定规则有关，常见排查和解决方法如下：

核心原因 #

• 项目中存在版本锁定文件：根目录下的package-lock.json、npm-shrinkwrap.json或yarn.lock中已经记录了16.x版本的react依赖，直接执行npm install react时npm会优先匹配锁定文件内的兼容版本，不会主动拉取最新大版本。
• npm源同步滞后：如果你使用的是国内镜像源、企业内部私有源，可能存在元数据同步不及时的问题，源端标记的latest版本对应的仍是16.14.0，而非官方最新的17版本。
• 存在上层/内置版本限制：项目package.json中已存在react的旧版本声明，或者父级目录存在package.json、.npmrc配置了react的版本范围，也可能是package.json中配置了overrides（npm8.3+）、resolutions（yarn）字段强制固定了react的版本范围。

解决方法 #

• 先执行npm view react version查看当前npm源标记的最新react版本，如果返回结果为16.14.0，说明源同步滞后，可以切换到npm官方源后再重试安装，或者直接指定版本安装。
• 要强制安装17版本，直接执行npm install react@17即可，命令执行完成后会自动更新package.json和锁定文件的版本记录。
• 个人项目安装前可以先删除根目录下的锁定文件，避免旧版本规则干扰，团队协作项目删除锁定文件前请确认不会影响其他依赖的兼容性。
• 检查项目根目录及上级目录的.npmrc、package.json文件，确认是否存在强制限制react版本的配置。

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