诸神缄默不语-个人技术博文与视频目录
这篇博文的适用场景是比如说反正你现在有了一个现成的npm项目，然后无论如何，你要把前端挂起来。
文章目录
- 一、准备工作
- 1. 安装 Node.js 和 npm
- 2. 克隆或获取项目代码
- 二、安装项目依赖
- 三、了解 npm 脚本命令
- 四、构建生产环境代码
- 五、运行生产环境服务器
- 六、其他常用命令
- 七、常见问题与解决方案
- 1. 构建后页面空白或资源加载失败
- 2. 构建时报错或内存不足
- 八、总结
一、准备工作
1. 安装 Node.js 和 npm
确保已安装 Node.js，它自带 npm（Node 包管理器）。安装后，可通过以下命令验证版本：
node -v
npm -v
2. 克隆或获取项目代码
如果项目托管在 Git 仓库中，可使用以下命令克隆项目：
git clone <项目仓库地址>
cd <项目目录>
二、安装项目依赖
在项目根目录下，执行以下命令安装项目所需的依赖包：
npm install
此命令会根据 package.json 文件中的 dependencies 和 devDependencies 字段，下载并安装所有依赖包到 node_modules 目录中。
如果遇到依赖冲突、安装失败或缓存问题，可以使用 --force 参数强制安装。会忽略本地缓存强制从镜像拉取包。
但是使用 --force 参数可能会导致安装不兼容的依赖，进而引发运行时错误。应谨慎使用，确保不会引入新的问题。
由于网络问题，所以直接从npm官方镜像下载可能下不下来，建议的解决方案是用镜像，如淘宝镜像：config set registry https://registry.npmmirror.com/
还有其它下载问题可以参考我写的另一篇博文：npm install --force从源无法下载包（ETARGET或E451），也没有自动新建node_modules文件夹，如何通过手动新建文件夹和下载指定无法下载的包来解决问题
三、了解 npm 脚本命令
在 package.json 文件中，scripts 字段定义了可执行的脚本命令。例如：
"scripts": {"build:prod": "vue-cli-service build --mode production","serve:prod": "node server.js"
}
其中：
build:prod：构建生产环境代码，通常包括代码压缩、优化等操作。serve:prod：启动生产环境服务器，通常用于本地预览构建后的项目。
四、构建生产环境代码
执行以下命令构建生产环境代码：
npm run build:prod
该命令通常会执行如下操作：
- 设置环境变量为生产环境（如
NODE_ENV=production）。 - 使用构建工具（如 Webpack、Vite）进行代码打包、压缩、优化。
- 生成构建后的文件，通常位于
dist或build目录中。
构建完成后，可在 dist 目录中看到生成的静态文件，如 index.html、js、css 等。
五、运行生产环境服务器
构建完成后，可使用以下命令启动本地服务器，预览生产环境效果：
npm run serve:prod
该命令通常会执行一个 Node.js 脚本（如 server.js），使用如 Express、Koa 等框架，启动一个本地服务器，监听特定端口（如 8080），并提供静态文件服务。
访问输出中展示的网址（一个本机访问的网址，如http://localhost:8080；一个其他设备方位的网址） 即可预览构建后的项目。
六、其他常用命令
除了上述命令，项目中可能还定义了其他脚本命令，如：
npm run dev：启动开发环境服务器，支持热更新，便于开发调试。npm run lint：使用 ESLint 等工具检查代码规范。npm run test：运行测试用例。
可通过以下命令查看所有可用的脚本命令：
npm run
七、常见问题与解决方案
1. 构建后页面空白或资源加载失败
可能原因是资源路径配置不正确。
解决方案：
在构建配置文件中（如 vue.config.js 或 webpack.config.js），将 publicPath 设置为相对路径：
module.exports = {publicPath: './'
};
2. 构建时报错或内存不足
可能原因是构建过程中消耗内存过多。
解决方案：
增加 Node.js 的内存限制，在构建命令中添加 --max_old_space_size 参数：
node --max_old_space_size=4096 node_modules/.bin/vue-cli-service build --mode production
或在 package.json 中的 scripts 中配置：
"scripts": {"build:prod": "node --max_old_space_size=4096 node_modules/.bin/vue-cli-service build --mode production"
}
八、总结
通过上述步骤，我们可以在已有的 npm 项目中，完成依赖安装、生产环境构建以及本地预览等操作。
掌握这些基本命令和配置，有助于提高开发效率，确保项目在不同环境下的正常运行。
如需进一步了解构建工具的高级配置（如 Webpack、Vite 等），建议查阅相关官方文档或社区教程。
