case-data-admin/ENV_README.md
2025-08-11 11:41:22 +08:00

2.1 KiB
Raw Blame History

环境配置说明

环境配置文件

项目包含以下环境配置文件:

1. .env.localhost - 本地开发环境

  • 用途: 本地开发时使用
  • API地址: http://127.0.0.1:5480
  • 启动命令: npm run dev:localhost

2. .env.development - 开发环境

  • 用途: 开发环境使用
  • API地址: http://127.0.0.1:5480
  • 启动命令: npm run dev

3. .env.dev-server - 开发服务器环境

  • 用途: 部署到开发服务器时使用
  • API地址: http://dev-casedata.igandan.com:5480
  • 启动命令: npm run build:dev-server

4. .env.test - 测试环境

  • 用途: 测试环境使用
  • API地址: http://127.0.0.1:5480
  • 启动命令: npm run build:test

5. .env.pre - 预发布环境

  • 用途: 预发布环境使用
  • API地址: https://preview.smartadmin.vip/smart-admin-api
  • 启动命令: npm run build:pre

6. .env.production - 生产环境

  • 用途: 生产环境使用
  • API地址: https://preview.smartadmin.vip/smart-admin-api
  • 启动命令: npm run build

自动环境检测

项目已实现自动环境检测功能,无需手动配置:

检测逻辑

  1. 本地环境: 自动检测 localhost127.0.0.1192.168.x.x 等IP地址
  2. 开发服务器: 自动检测 dev-casedata.igandan.com 域名
  3. 其他环境: 使用配置文件中的 VITE_APP_API_URL

端口配置

  • 本地环境: 5480
  • 开发服务器: 5480
  • 其他环境: 根据配置文件

使用方法

开发时

# 本地开发
npm run dev:localhost

# 开发环境
npm run dev

部署时

# 部署到开发服务器
npm run build:dev-server

# 部署到测试环境
npm run build:test

# 部署到预发布环境
npm run build:pre

# 部署到生产环境
npm run build

注意事项

  1. 端口统一: 所有环境都使用5480端口
  2. 自动检测: 无需手动修改代码,系统会自动判断环境
  3. 配置优先级: 环境检测 > 配置文件 > 默认值
  4. 开发便利: 本地开发时自动使用127.0.0.1:5480部署时自动使用dev-casedata.igandan.com:5480