npm install后package-lock.json未更新，需删node_modules和package-lock.json再执行npm install重置；或用npm install --no-save确保仅按lock文件安装。
npm install 后 package-lock.json 没更新怎么办
VSCode 里点 npm Explorer 的“Install”按钮，或在集成终端敲 npm install，但提交 Git 时发现 package-lock.json 没变——这说明依赖没真正锁定，CI 构建时很可能拉到不一致版本。
- 根本原因：npm 默认只在显式安装（如
npm install lodash@4.17.0）或首次生成 lock 文件时才写入；npm install无参数时若 lock 文件存在且package.json未变，它可能跳过写入 - 验证方式：执行
npm ls lodash看输出版本是否和package.json一致；再对比cat package-lock.json | grep lodash的 version 字段 - 强制同步：删掉
node_modules和package-lock.json，再运行npm install—— 这是最干净的重置方式 - 自动化防护：在
preinstall或precommit脚本里加npm ci（只读 lock 文件）或npm install --no-save防止意外修改
pip 安装后 requirements.txt 和实际环境不一致
VSCode 点击 requirements.txt 右键选 “Install requirements”，但运行时仍报 ModuleNotFoundError，大概率是 pip 没装进当前解释器环境，或者 requirements.txt 本身没反映真实依赖。
- 检查解释器路径：右下角状态栏点 Python 版本 → 确认路径含
venv/或.venv/；再在集成终端跑which python和python -m pip --version，确保两者指向同一环境 - 别用
pip freeze > requirements.txt：它会把pip、setuptools、wheel全 dump 出来，污染部署环境 - 推荐做法：
pipreqs . --force（只扫描 import）或pip-compile requirements.in（用 pip-tools 管理顶层依赖） - 关键动作：安装完立刻运行
pip list --outdated，确认没残留旧包；再用pip check验证依赖兼容性
VSCode 自动升级依赖时忽略 peerDependencies 冲突
npm Explorer 或 Python Environment Manager 界面里点“Update all”，结果项目启动失败——这类图形工具普遍不校验 peerDependencies 兼容性，尤其对 React、Vue、TypeScript 插件生态影响巨大。
- React 生态典型问题：
eslint-plugin-react@19.x要求react@18.x，但 UI 工具升级了 eslint 插件却没动 react，TS 类型检查直接崩 - 真实验证命令：
npm install --dry-run（模拟安装看冲突）、npm ls react（查实际解析版本）、npm view eslint-plugin-react peerDependencies（查插件要求） - 安全升级路径：先
npm outdated查哪些可升，再逐个npm install xxx@latest --save-dev，配合--save-exact锁死主版本 - 配置加固：在
package.json加"resolutions"字段强制统一子依赖版本，比如"resolutions": {"lodash": "4.17.21"}
Java Maven 依赖树中 runtime scope 包被漏加载
VSCode 用 Maven for Java 插件管理 pom.xml，但运行时找不到 JDBC 驱动或 Log4j 实现类——问题常出在 runtime 作用域依赖未被 IDE 正确识别进 classpath。
- 现象特征：
mvn compile成功，mvn test成功，但 VSCode Debug 启动报ClassNotFoundException - 排查步骤：在终端执行
mvn dependency:tree -Dscope=runtime，确认目标包（如mysql-connector-java）确实在 runtime 分支下 - VSCode 行为差异：Maven 插件默认只将
compile和testscope 加入编辑器 classpath；runtime包需手动触发“Reload project”或重启语言服务器 - 临时修复：右键
pom.xml→ “Maven: Reload project”；长期方案：在.vscode/settings.json加"maven.ignoredDependencies": []禁用忽略逻辑
requirements.txt 不是“生成一次就完事”的快照，而是必须随每次依赖变更**主动验证并提交**的契约文件。图形界面点几下装完包，不代表契约已更新。
