npm run build 是执行 package.json 中 build 脚本的命令，需确保 scripts 字段已定义（如 "build": "vite build"），且构建工具（如 vite、webpack）已作为 devdependencies 安装，npm 会自动从 node_modules/.bin 中调用对应命令。

在 JavaScript 项目中，npm run 是执行 package.json 中预定义脚本的命令，构建（build）通常指将源代码（如 TypeScript、JSX、SCSS）编译、打包、压缩为生产可用的静态文件。要让它正常工作，关键不是“怎么输命令”，而是确保配置已正确写入脚本并依赖项就位。

确认 package.json 里有 build 脚本

打开项目的 package.json 文件，在 "scripts" 字段下找到或添加类似这样的条目：

• "build": "webpack --mode production"（用 Webpack）
• "build": "tsc --build"（用 TypeScript 的项目引用）
• "build": "vite build"（Vite 项目）
• "build": "react-scripts build"（CRA 创建的 React 项目）

只要存在 "build" 这个键，你就可以直接运行 npm run build —— 不需要额外配置运行器。

确保构建工具已安装

脚本里写的命令（比如 vite、webpack）必须能被 npm 找到。推荐方式是：把构建工具作为 devDependencies 安装：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 运行 npm install --save-dev vite（如果脚本用的是 vite build）
• 运行 npm install --save-dev webpack webpack-cli（如果用 Webpack）

npm 会优先从 node_modules/.bin/ 中找命令，所以全局安装不是必须的，反而容易引发版本冲突。

运行构建命令

在项目根目录（即有 package.json 的文件夹）下，终端输入：

npm run build

注意：npm run 后面跟的是 scripts 里的键名，不是文件名或路径。如果脚本名叫 "build:prod"，就得输 npm run build:prod。

查看输出和常见问题

成功时，终端通常会显示打包完成、生成文件数量、体积大小等信息，并在默认输出目录（如 dist/、build/）生成静态文件。

• 报错 command not found？检查工具是否已安装在 devDependencies，且 package.json 脚本拼写正确
• 报错 Cannot find module 'xxx'？可能是依赖未安装完整，尝试 npm install 再重试
• 想看详细日志？加 --verbose： npm run build --verbose

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南