3、开发环境初始化：Node.js/Python运行时配置、依赖管理（npm/pip）、环境变量与配置文件

在搭建自助容量压测作业平台的过程中，WebIDE 脚本编辑环境的核心是运行时与依赖管理。本章将指导你完成 Node.js 与 Python 双运行时的初始化配置，掌握 npm 与 pip 的依赖管理策略，并规范环境变量与配置文件的加载机制。这是后续脚本开发与压测任务执行的基础保障。

3.1 运行时版本选择与安装

平台需同时支持 Node.js 和 Python 两种脚本语言，以满足不同压测场景的需求。运行时版本需遵循 LTS（长期支持）原则，确保稳定性与兼容性。

3.2 依赖管理：npm 与 pip

依赖管理是脚本可移植性与可复现性的关键。Node.js 使用 npm（或 yarn/pnpm），Python 使用 pip（或 poetry/conda）。平台需为每个压测脚本项目维护独立的依赖环境。

3.2.1 Node.js 依赖管理（npm）

每个压测脚本项目应包含 package.json 文件，明确声明依赖与版本。使用 package-lock.json 锁定依赖树。

// package.json 示例
{
  "name": "loadtest-script",
  "version": "1.0.0",
  "private": true,
  "dependencies": {
    "axios": "^1.6.0",
    "k6": "^0.0.0"
  },
  "devDependencies": {
    "eslint": "^8.50.0"
  }
}

常用 npm 命令：

• npm install — 安装所有依赖（基于 package-lock.json）
• npm install <package>@<version> --save — 安装并写入 dependencies
• npm ci — 严格锁定版本安装（CI/CD 环境推荐）
• npm audit — 检查依赖安全漏洞

3.2.2 Python 依赖管理（pip）

Python 项目使用 requirements.txt 或 pyproject.toml 管理依赖。推荐使用虚拟环境隔离项目依赖。

# requirements.txt 示例
requests==2.31.0
locust==2.20.0
pandas==2.1.0

常用 pip 命令：

• pip install -r requirements.txt — 批量安装依赖
• pip install <package>==<version> — 安装指定版本
• pip freeze > requirements.txt — 导出当前环境依赖清单
• python -m venv .venv — 创建虚拟环境

3.3 环境变量与配置文件

压测脚本通常需要读取目标服务地址、认证令牌、并发数等动态配置。平台需提供统一的环境变量注入机制与配置文件加载规范。

3.3.1 环境变量加载优先级

平台采用分层加载策略，确保配置可覆盖、可追溯：

1. 系统级环境变量（如 PATH、HOME）
2. 平台全局配置（如压测集群地址、默认超时时间）
3. 项目级 .env 文件（存放于脚本项目根目录）
4. 运行时注入变量（WebIDE 界面或 API 调用时动态传入）

3.3.2 配置文件规范

平台推荐使用 YAML 或 JSON 格式的配置文件，存放于脚本项目根目录的 config/ 文件夹下。示例结构：

# config/default.yaml
target:
  host: "http://api.example.com"
  timeout: 30000
load:
  virtual_users: 100
  ramp_up: 60
  duration: 300
report:
  output_dir: "./reports"
  format: "json"

Node.js 读取示例：

const dotenv = require('dotenv');
const yaml = require('js-yaml');
const fs = require('fs');

// 加载 .env 文件
dotenv.config();

// 加载 YAML 配置文件
const config = yaml.load(fs.readFileSync('./config/default.yaml', 'utf8'));

// 环境变量覆盖配置
config.target.host = process.env.TARGET_HOST || config.target.host;

Python 读取示例：

import os
import yaml
from dotenv import load_dotenv

# 加载 .env 文件
load_dotenv()

# 加载 YAML 配置文件
with open('config/default.yaml', 'r') as f:
    config = yaml.safe_load(f)

# 环境变量覆盖配置
config['target']['host'] = os.getenv('TARGET_HOST', config['target']['host'])

3.4 环境初始化流程总览

下图展示了从运行时安装到脚本可执行的整体初始化流程：

3.5 常见问题与避坑指南