命令速查表

本附录默认你位于 servicedesk-practice 根目录，使用 Windows PowerShell。

文件与目录

命令	作用
pwd	查看当前目录
ls	列出当前文件
cd servicedesk-practice	进入项目目录
cd ..	返回上一层
mkdir server\src	创建文件夹
code .	用 VS Code 打开当前目录

初始化与安装

命令	作用
npm init -y	创建 package.json
npm create vite@latest client -- --template vue-ts	创建 Vue + TypeScript 前端
npm install	安装 workspace 中所有依赖
npm install -w server express cors	给后端安装依赖
npm install -w client axios pinia vue-router	给前端安装依赖
npm install -D -w server vitest	安装后端开发依赖

-w client 表示目标 workspace 是 client，不会把只属于前端的依赖装到后端。

开发和验收

命令	作用
npm run dev	同时启动前后端开发服务器
npm run typecheck	检查 TypeScript 类型
npm run lint	检查代码问题
npm run format:check	检查格式
npm test	执行自动测试
npm run build	生产构建

启动命令运行中时，用 Ctrl + C 停止服务。

API 调试

Invoke-RestMethod http://localhost:3001/api/v1/health

$login = Invoke-RestMethod -Method Post -Uri http://localhost:3001/api/v1/auth/login `
  -ContentType "application/json" `
  -Body '{"username":"user","password":"123456"}'

$token = $login.data.accessToken
Invoke-RestMethod -Uri http://localhost:3001/api/v1/auth/profile `
  -Headers @{ Authorization = "Bearer $token" }

PowerShell 行末的反引号 ` 表示下一行仍属于同一条命令。

MySQL 模式

命令	作用
docker compose up -d mysql	在后台启动 MySQL
docker compose ps	查看容器状态
Copy-Item server\.env.example server\.env	创建本地环境配置
npm run db:init -w server	建表并写入演示数据
docker compose stop mysql	暂停数据库容器

迷路时的三步

pwd
ls
npm run dev

先确认你是否位于根目录，再观察缺失的文件或运行输出；不要在不确定目录时反复安装依赖。