VSCode中npm命令报错的三大主因是npm全局路径未加入PATH、Webpack loader缺失、package.json中scripts名称冲突；需先验证node/npm是否全局可用，再检查npm config get prefix路径是否在PATH中，确保loader按需安装并正确配置，scripts命名避免覆盖。
能跑起来，但多数人卡在 npm 全局路径、loader 缺失、scripts 冲突这三处。
确认 Node 和 npm 已正确安装并可全局调用
VSCode 本身不自带 Node 环境，它只是编辑器，所有命令（node、npm、webpack）都依赖系统 PATH。很多人在 VSCode 终端里报 command not found，其实不是 VSCode 问题，而是安装时没勾选“Add to PATH”或手动配置漏了。
- 打开系统终端（不是 VSCode 内置终端），运行
node -v和npm -v，必须有输出；否则重装 Node.js，Windows 安装时务必勾选 Add Node.js to PATH - 检查
npm config get prefix输出的路径是否在系统环境变量PATH中——尤其当你改过全局模块路径（比如设为D:\node_global），就得手动把该路径加进系统PATH - VSCode 启动后，如果终端仍找不到命令，关掉所有 VSCode 实例，再重新打开，否则它不会自动读取新 PATH
Webpack 要么全局装，要么项目本地装，别混着来
全局安装（npm install -g webpack webpack-cli）看似省事，但版本容易和项目冲突，CI/CD 或多人协作时不可靠。推荐只装本地依赖，靠 npx 或 npm run 调用。
- 在项目根目录运行
npm init -y初始化package.json - 执行
npm install webpack webpack-cli --save-dev，装完后node_modules/.bin/webpack就有了可执行文件 - 验证：在 VSCode 终端中运行
npx webpack --version，能输出版本号说明本地 webpack 可用 - 如果用
npm run build，确保package.json的scripts里定义了对应命令，例如："build": "webpack --mode production"
Vue 或 TS 项目必须配 loader，否则 Module parse failed
Webpack 默认只认识 JS，遇到 .vue、.ts、.scss 等后缀会直接报错，不是 webpack 装错了，是缺 loader。
- Vue 项目要加
vue-loader和vue-template-compiler（注意版本匹配 Vue 2/3）：npm install vue-loader vue-template-compiler --save-dev - TypeScript 项目要加
ts-loader和typescript：npm install ts-loader typescript --save-dev - 配置
webpack.config.js时，module.rules必须显式声明test和loader，比如{ test: /\.vue$/, loader: 'vue-loader' } - 别忘了插件：Vue 需要
VueLoaderPlugin，TS 需要new webpack.DefinePlugin({ 'process.env': {...} })等常见适配
package.json 里的 scripts 名称不能重复
很多教程直接写 "build": "webpack --mode production"，但如果你用 Vue CLI 或 Vite 创建过项目，package.json 里可能已有 build 字段，再覆盖会导致原有构建逻辑丢失。
- 运行
cat package.json | grep build（macOS/Linux）或findstr build package.json（Windows）确认是否已存在build - 建议改用语义化名称，比如
"build:webpack": "webpack --mode production"，然后用npm run build:webpack调用 - VSCode 内置的「运行脚本」功能（Ctrl+Shift+P → “NPM Scripts”）会自动识别所有
scripts，命名清晰更方便点击触发
真正卡住人的，从来不是 webpack 配置本身，而是 node_modules 没装全、PATH 没生效、或者 scripts 键名悄悄被覆盖了。动手前先在终端里逐条验证 node、npx webpack、npm run xxx 是否真能走通，比对着配置文件猜错误快得多。
