ln-web

📖 项目脚本使用说明

本项目在 package.json 中定义了一系列常用脚本，用于本地开发、构建、发布和部署。
以下是每个脚本的功能及使用方法。

---

📝 常用工作流

本地开发

npm install # 安装依赖
npm run dev # 启动开发环境

打包并部署测试环境

npm run deploy:test # 单机版环境

发布新版本

npm run release # 发布新版本 + 生成发布日志

同步分支代码

bash scripts/merge_dev_to_pro.sh # 同步dev分支到prod分支

---

🎯 命令速查表

说明：目前分为开发、测试/单机版、生产/集成环境 | 环境 | 命令 | 端口 / 说明 | |------|------|------------| | 🟢 开发环境 | npm run dev | 3000 | | 🟡 测试环境 | npm run dev:test | 4000 | | 🔴 生产环境 | npm run dev:pro | 5000 | | 📦 构建开发环境 | npm run build:dev | - | | 📦 构建测试环境 | npm run build:test | - | | 📦 构建生产环境 | npm run build | - | | 🚀 发布版本 | npm run release | 发布版本 + 生成日志 | | 📤 部署测试环境 | npm run deploy:test | 打包 + 部署 | | 🔍 类型检查 | npm run type-check | TypeScript 检查 | | 🧹 代码修复 | npm run lint | ESLint 自动修复 | | 🎨 格式化代码 | npm run format | Prettier 格式化 |

---

📦 开发相关

命令	说明	运行示例
npm run dev	启动开发环境（development），端口 3000	npm run dev
npm run dev:test	启动测试环境（test），端口 4000	npm run dev:test
npm run dev:pro	启动生产环境（production）本地调试，端口 5000	npm run dev:pro

---

🏗 构建相关

命令	说明	运行示例
npm run build:dev	打包 开发环境 构建产物	Jenkins代替
npm run build:test	打包 测试环境 构建产物	npm run build:test
npm run build	打包 生产环境 构建产物	Jenkins代替

---

🚀 发布相关

命令	说明	运行示例
npm run release	发布版本 + 生成日志	npm run release

---

📤 部署相关

命令	说明	运行示例
npm run deploy:test	打包测试环境 并执行部署脚本	npm run deploy:test
npm run run:deploy	直接执行部署脚本（不打包）	npm run run:deploy

⚠ run:deploy 会调用 scripts/deploy.ps1（PowerShell 脚本），需确保本地已安装 PowerShell 且允许执行脚本。

---

👀 预览构建产物

命令	说明	运行示例
npm run preview	本地预览已构建的生产环境包（默认端口 4173）	npm run preview

---

🔍 代码检查与格式化

命令	说明	运行示例
npm run type-check	TypeScript 类型检查	npm run type-check
npm run lint	ESLint 代码规范检查并自动修复问题	npm run lint
npm run format	使用 Prettier 格式化 src/ 目录下的代码	npm run format

---