npm install后require仍报“Cannot find module”需确认三点：当前打开的是含package.json的项目根目录；package.json中已声明该依赖（用npm list验证）；Windows用户须避免路径含中文或空格，否则符号链接损坏导致VSCode无法遍历node_modules。
npm install 后 require 还报 “Cannot find module” 怎么办
不是装了就完事，VSCode 能否识别依赖，取决于它是否能按 Node.js 的模块解析规则找到 node_modules。常见卡点有三个：
- 当前打开的文件夹不是项目根目录（即不含
package.json的那一层），VSCode 的 JS/TS 语言服务会直接失效，node_modules不被扫描 -
package.json里没真正写入该包：运行npm list <pkg-name></pkg-name>，若输出empty或报ENOTDIR，说明安装路径错了（比如在父级目录执行了npm install） - Windows 下路径含中文或空格（如
D:\我的项目\app），会导致node_modules内部符号链接损坏，VSCode 无法遍历——必须挪到纯英文无空格路径再npm install
import 报 “Cannot use import statement outside a module” 是编辑器问题吗
不是 VSCode 标红的问题，是 Node.js 运行时拒绝执行。根本原因是文件没被识别为 ES Module。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 检查项目根目录
package.json是否有"type": "module"字段，没有就加进去 - 不想改
package.json？把文件后缀从.js改成.mjs，Node.js 遇到这个扩展名会强制启用 ES Module 模式 - 用
import加载本地文件时，路径必须带扩展名：import { foo } from './utils.js'，省略.js会直接报错 - 别用 Code Runner 插件跑 —— 它常忽略
package.json的type字段，改用 VSCode 内置终端执行node index.js验证
为什么断点进不到 node_modules 里的源码
VSCode 默认不加载第三方包的 source map，即使包里自带 sourceMappingURL，也不会自动跳转。
- 想单步调试依赖源码，必须在
.vscode/launch.json的配置里显式开启："resolveSourceMapLocations": ["!*"] - 确保你装的是带 source map 的包版本（比如
axios@1.7+默认带，但某些精简版或打包版可能删了） - 如果依赖是 TypeScript 编写的，还需确认其
package.json中有"types"字段且指向有效的.d.ts文件，否则 VSCode 只能读 JS，无法推导类型
动态注入依赖时，require 路径怎么写才不会崩
Node.js 的模块查找是递归向上找 node_modules 的，但实际开发中容易因路径层级错乱导致加载错包。
- 绝对路径慎用：
require('/src/utils')会绕过模块解析机制，直接按文件系统路径找，一旦项目结构变动立刻失效 - 相对路径要从当前文件出发算起：
require('../lib/db')—— 注意上级目录数不能少，也不能多 - 想跨多层目录又不想写一串
../？在package.json里加"exports"字段定义子路径入口，例如："./utils": "./src/utils/index.js"，然后用require('your-pkg/utils') - ESM 下
import不支持 Node.js 的自动index.js解析，import './config'必须写成import './config/index.js'或明确指定文件
node_modules 场景下，一个 require 调用背后可能涉及三层查找逻辑，手动 debug 时得同时看 process.cwd()、__dirname 和 VSCode 当前工作区根路径。 
