【赫兹威客】框架模板-前端命令行部署教程

本文档为前端项目的命令行手动部署教程，通过CMD执行命令完成依赖安装与服务启动，操作灵活且适配各类环境，全程可结合"前端命令行部署"视频参考操作。操作前需确保基础环境已配置完成，核心命令及操作逻辑清晰标注，便于新手上手。

一、前期准备：确认基础环境与项目完整性

前端命令行部署依赖Node.js环境及完整的项目文件，需提前完成环境验证与项目检查，避免后续操作报错。

1.1 验证Node.js环境

前端部署依赖Node.js的npm包管理工具，需先完成Node.js的安装与版本验证，具体安装步骤可参考总教程"1.5 Node.js安装"章节。验证方法：打开CMD命令提示符，输入"node -v"并回车，若返回类似"v24.11.1"的版本号，说明环境配置正常。

1.2 确认项目文件完整性

确保前端项目文件夹（通常命名为"hertz_server_django_ui"）完整，核心文件包括：package.json （依赖配置文件）、src （源码文件夹）、public（静态资源文件夹），缺失这些文件会导致部署失败。

二、核心部署步骤

命令行部署需依次完成"切换工作目录→安装依赖→启动服务"三个核心步骤，所有操作均在前端项目根目录下执行，需确保命令输入准确。

步骤1：切换至前端项目根目录

1. 打开CMD命令提示符或PyCharm内置终端（推荐，无需手动切换环境）。

2. 执行"cd 项目路径"命令，将工作目录切换至前端项目根目录。其中"项目路径"需替换为实际路径，示例如下：

命令示例：cd C:\Users\Administrator\Downloads\hertz_django\hertz_server_django_ui

步骤2：安装前端项目依赖

1.在已切换的项目根目录下，执行依赖安装命令：npm install。

2.命令执行后，npm会自动读取"package.json"中的依赖配置，下载并安装所有必需的前端依赖包（如Vue、Vite等），依赖包会统一存放在自动生成的"node_modules"文件夹中。

步骤3：启动前端服务

1. 保持终端在项目根目录，执行服务启动命令：npm run dev。

2. 命令执行后，Vite（前端构建工具）会编译项目源码，终端会显示编译进度。若出现以下内容说明编译成功。

3.服务启动成功的核心标志：终端会输出本地访问地址，通常为"Local: http://localhost:3000/"或"http://localhost:3001/"（端口号由项目配置决定，以实际显示为准）。