Appearance
前端项目命令行手动部署教程
本文档为前端项目的命令行手动部署教程，通过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：切换至前端项目根目录
打开CMD命令提示符或PyCharm内置终端（推荐，无需手动切换环境）。
执行“cd 项目路径”命令，将工作目录切换至前端项目根目录。其中“项目路径”需替换为实际路径，示例如下：
命令示例：cd C:\Users\Administrator\Downloads\hertz_django\hertz_server_django_ui
步骤 2：安装前端项目依赖
在已切换的项目根目录下，执行依赖安装命令：npm install。
命令执行后，npm会自动读取“package.json”中的依赖配置，下载并安装所有必需的前端依赖包（如Vue、Vite等），依赖包会统一存放在自动生成的“node_modules”文件夹中。
步骤 3：启动前端服务
npm install 执行完成后，执行启动命令“npm run dev”。命令行输出成功后会显示类似“Local:
http://localhost:3000”或“http://localhost:3001”的访问地址（端口号由项目配置决定，以实际显示为准）。命令执行后，Vite（前端构建工具）会编译项目源码，终端会显示编译进度。若出现以下内容说明编译成功。
服务启动成功的核心标志：终端会输出本地访问地址，通常为“Local:
http://localhost:3000/”或“http://localhost:3001/”（端口号由项目配置决定，以实际显示为准）。