2. 开发环境与依赖配置

本章指导如何选择支付SDK支持的主流开发语言，通过包管理工具声明依赖并下载SDK，以及通过环境变量注入密钥与端点配置。正确的依赖与配置管理是后续加密传输与安全校验的基础，任何版本不匹配或密钥泄露都会导致运行时安全漏洞。

2.1 开发语言选择

支付SDK通常以多语言分发包的形式发布，覆盖Java、Go、Python、Node.js和C++等常见后端语言。选择原则包括：

• 团队技术栈：优先使用团队已有经验的生态语言，降低学习成本。
• SDK维护力度：优先选择官方长期维护、版本更新频繁的语言包。
• 性能与并发：高并发支付网关优先考虑Go或Java（Netty）实现；轻量微服务可选Node.js。
• 跨构建系统：C++项目需确认SDK支持CMake、vcpkg或Conan等工具。

下表列出常见语言对应的SDK包名和包管理入口：

2.2 包管理工具引入SDK

以下为各语言典型依赖声明示例。注意：版本号务必锁定至具体修订号（如1.2.3），避免用+或x.x导致非预期升级引入破坏性兼容变更。

Java (Maven pom.xml)

<dependency>
    <groupId>com.example</groupId>
    <artifactId>payments-sdk</artifactId>
    <version>1.2.3</version>
</dependency>

Java (Gradle build.gradle)

implementation 'com.example:payments-sdk:1.2.3'

Go (go.mod)

require github.com/example/payments-sdk v1.2.3

Python (requirements.txt)

payments-sdk-python==1.2.3

Node.js (package.json)

"dependencies": {
  "@example/payments-sdk": "1.2.3"
}

C++ (CMakeLists.txt via FetchContent)

FetchContent_Declare(
  payments-sdk
  GIT_REPOSITORY https://github.com/example/payments-sdk.git
  GIT_TAG v1.2.3
)
FetchContent_MakeAvailable(payments-sdk)
target_link_libraries(myapp PRIVATE payments_sdk)

2.3 环境变量设置

支付SDK的密钥、商户ID、API端点等敏感配置不可硬编码在代码仓库中。推荐通过环境变量注入，并在应用启动时由SDK读取。常见环境变量约定如下：

• PAYMENT_ – 商户
• PAYMENT_MERCHANT_ID – 商户ID
• PAYMENT_API_BASE_URL – 支付网关域名（用于沙箱/生产环境切换）
• PAYMENT_SIGN_TYPE – 签名算法（如 RSA256 / HMAC-SHA256）

Unix / Linux / macOS (bash)

export PAYMENT_="sk_live_abcd1234"
export PAYMENT_MERCHANT_ID="merchant-001"
export PAYMENT_API_BASE_URL="https://api.payments.com/v3"

Windows (PowerShell)

$env:PAYMENT_ = "sk_live_abcd1234"
$env:PAYMENT_MERCHANT_ID = "merchant-001"
$env:PAYMENT_API_BASE_URL = "https://api.payments.com/v3"

Docker Compose (.env + env_file)

# docker-compose.yml
services:
  app:
    env_file:
      - .env.production
# .env.production
PAYMENT_=sk_prod_efgh5678
PAYMENT_MERCHANT_ID=merchant-001
PAYMENT_API_BASE_URL=https://api.payments.com/v3

以下流程图展示从语言选择→依赖引入→环境配置→SDK初始化验证的完整开发环境搭建流程：