ln-web

基础信息

nodejs 20.19.0
pnpm 10.12.4

本地开发

  npm run dev # 启动研发环境
  npm run dev:test # 启动测试环境
  npm run dev:pro # 启动生产环境

构建说明

项目提供了多种构建方式，分别适用于不同的场景：

  # 构建生产环境
  npm run build # 不生成tag分支与版本文件
  # 以下脚本都会生成tag分支与版本文件
  npm run build:test # 构建测试环境
  npm run build:pro # 构建生成环境
  npm run build:tag:test # 基于特定tag 构建测试环境
  npm run build:tag:pro # 基于特定tag 构建生产环境

1、测试构建

用于日常开发测试，自动生成带时间戳的测试版本tag，如：test-202508061340

  npm run build:test

• 执行该命令会：
  • 自动生成格式为 test-YYYYMMDDHHmm 的tag
  • 在dist目录下生成包含版本信息的 version.json 文件
  • 不会修改 package.json 中的版本号

2、发布构建

用于发布正式版本，自动生成带版本号的tag,如：publish-v0.0.2

  npm run build:pro

• 执行该命令会：
  • 自动生成格式为 publish-vX.X.X 的tag
  • 在dist目录下生成包含版本信息的 version.json 文件
  • 会更新 package.json 中的版本号

3、基于特定tag构建

用于基于已有的tag进行构建，用于重新构建特定tag版本的代码

  npm run build:tag:test # 基于特定tag 构建测试环境
  npm run build:tag:pro # 基于特定tag 构建生产环境

4、构建注意事项

1. 确保在执行构建命令前已提交所有更改
2. 发布构建会修改 package.json 中的版本号，请确保有相应的权限
3. 基于指定 tag 版本构建会切换工作目录到指定 tag 分支，构建完成后会自动切换回原分支，若切换失败则需手动切换回原分支
4. 所有构建命令都会自动创建对应的 git tag，用于版本追踪，仅打包构建除外
5. 构建完成后，建议手动检查 dist 目录下的文件，确保无误

5、仅打包构建

适用于仅打包，不生成 tag 的场景

  npm run build

• 执行该命令后，仅会打包生成 dist 目录，不会生成 tag，也不会修改 package.json 中的版本号