关于运行 npm run serve/dev 运行不起来，node_modules Git忽略不了等（问题）

原创已于 2025-03-21 14:44:00 修改 · 1k 阅读

CC 4.0 BY-SA版权

文章标签：

于 2025-03-17 19:48:24 首次发布

2 篇文章

订阅专栏

前言：需要根据项目的情况、场景自行辨别对应的情况

情况一
直接 clone 的项目忘了 npm install，这种情况看一下当前项目是否存在 node_modules，没有的话 npm i 然后运行就好了
情况二
error when starting dev server:
TypeError: crypto$2.getRandomValues is not a function
该情况是 node 版本不对应，新版的 vite 项目需要更高的 node 版本，需要 Node.js 18+ 版本运行

可以安装一个 nvm 做 node 版本控制，对于多个项目中的 node 切换非常方便

情况三
项目中已经存在 node_modules 还是无法运行，需要重新 npm i，这种情况大概率是丢失了 .bin 文件导致的运行不了
特殊情况
在内网环境下，项目初期将 node_modules 与代码一起提交到 Git 仓库。由于同事的代码迭代，导致 Git 仓库中 .bin 文件丢失，使得最新版本的代码无法运行。本地 node_modules 未变动，导致 Git 仓库与本地代码一致，但依赖包不一致。项目刚接手时发现代码无法运行，部分功能在几个月前正常，最近突然失效。（气不活了😂，这个项目刚转到我手上结果代码跑不起来，问题排查搞了一下午）

解决方案

克隆项目到两个目录
- 主文件目录：用于日常开发和代码提交
- 切换文件目录：用于切换分支，寻找包含完整 .bin 文件的 node_modules
查找可用的 node_modules
- 在切换文件目录中，从最新提交开始，逐步回退到历史提交
- 检查每个提交的 node_modules 是否包含 .bin 文件
- 找到第一个包含完整 .bin 文件的提交
替换 node_modules
- 删除主文件目录中的 node_modules
- 将切换文件目录中找到的完整 node_modules 复制到主文件目录（注意：必须删除原有 node_modules，直接替换可能无效）
验证项目功能
- 运行项目，检查功能是否恢复正常
- 如果功能正常，提交代码到 Git 仓库

由于在远端仓库已经推过了 node_modules，导致即使在 .gitignore 文件中配置了也无法忽略
解决方案

忽略 node_modules 文件，git rm -r --cached node_modules 该指令并不是删除了 node_modules，只是做了忽略处理
还有一种情况是该项目的包已经锁定，不需要忽略 node_modules，但是每次运行项目的时候会产生不一样缓存文件 node_modules/.cache，这样会造成每次提交代码会提交一堆缓存文件，可以单独忽略 git rm -r --cached node_modules/.cache