# Python程序运行环境详解 ## 1. 基础运行环境要求 ### 必需软件组件： | 软件名称 | 版本要求 | 作用说明 | |---------|----------|----------| | **Python解释器** | 3.7+ | 执行Python代码的核心引擎 | | **代码编辑器/IDE** | - | 编写和调试代码的工具 | | **包管理工具** | pip | 安装和管理第三方库 | ## 2. 详细配置步骤 ### 方案一：使用Anaconda（推荐初学者） ```bash # 1. 下载安装Anaconda # 访问: https://www.anaconda.com/download # 2. 创建专用环境 conda create -n stage_lighting python=3.9 conda activate stage_lighting # 3. 安装所需包 pip install ffmpeg-python numpy ``` ### 方案二：直接安装Python ```bash # 1. 从官网下载Python # https://www.python.org/downloads/ # 2. 验证安装 python --version pip --version # 3. 安装项目依赖 pip install ffmpeg-python numpy matplotlib pyserial ``` ## 3. 代码编辑器选择 ### 推荐选项： | 编辑器 | 特点 | 适用人群 | |--------|------|----------| | **VS Code** | 轻量、插件丰富、免费 | 所有用户 | | **PyCharm** | 专业、功能全面 | 专业开发者 | | **Jupyter Notebook** | 交互式、适合数据分析 | 数据分析师 | ### VS Code配置示例： ```json // settings.json 配置 { "python.pythonPath": "venv\\Scripts\\python.exe", "python.linting.enabled": true, "python.formatting.provider": "black" } ``` ## 4. FFmpeg环境配置 ### Windows系统： ```bash # 1. 下载FFmpeg # https://ffmpeg.org/download.html # 2. 添加到系统PATH # 右键"此电脑" → 属性 → 高级系统设置 → 环境变量 # 在Path中添加FFmpeg的bin目录路径 # 3. 验证安装 ffmpeg -version ``` ### 使用conda安装FFmpeg： ```bash conda install ffmpeg ``` ## 5. 完整环境验证脚本 创建 `environment_test.py` 文件： ```python #!/usr/bin/env python3 """ 环境验证脚本 运行此脚本检查所有依赖是否正常 """ def test_environment(): print("🔍 开始环境验证...") # 测试Python版本 import sys print(f"✅ Python版本: {sys.version}") # 测试核心库 try: import numpy as np print("✅ NumPy安装正常") except ImportError: print("❌ NumPy未安装") return False # 测试ffmpeg-python try: import ffmpeg print("✅ ffmpeg-python安装正常") except ImportError: print("❌ ffmpeg-python未安装") return False # 测试FFmpeg可执行文件 import subprocess try: result = subprocess.run(['ffmpeg', '-version'], capture_output=True, text=True) if result.returncode == 0: print("✅ FFmpeg可执行文件正常") else: print("❌ FFmpeg执行失败") return False except FileNotFoundError: print("❌ FFmpeg未安装或未添加到PATH") return False # 测试串口通信（PLC相关） try: import serial print("✅ pyserial安装正常") except ImportError: print("⚠️ pyserial未安装（PLC通信需要）") print("\n🎉 环境验证完成！可以运行舞台灯光系统程序") return True if __name__ == "__main__": test_environment() ``` ## 6. 项目文件结构 创建如下目录结构： ``` stage_lighting_system/ ├── main.py # 主程序入口 ├── audio_analyzer.py # 音频分析模块 ├── plc_communicator.py # PLC通信模块 ├── requirements.txt # 依赖包列表 ├── test/ # 测试文件 │ ├── test_audio.mp3 │ └── environment_test.py └── docs/ # 文档 └── README.md ``` ### requirements.txt 内容： ```txt ffmpeg-python==0.2.0 numpy==1.21.0 matplotlib==3.4.0 pyserial==3.5 ``` 安装所有依赖： ```bash pip install -r requirements.txt ``` ## 7. 运行程序步骤 ### 方法一：命令行运行 ```bash # 1. 激活环境 conda activate stage_lighting # 2. 进入项目目录 cd stage_lighting_system # 3. 运行主程序 python main.py ``` ### 方法二：使用VS Code运行 1. 打开项目文件夹 2. 按 `F5` 或点击运行按钮 3. 选择Python解释器 ### 方法三：创建批处理文件（Windows） 创建 `run.bat`： ```batch @echo off call conda activate stage_lighting python main.py pause ``` ## 8. 常见问题解决 ### 问题1：ModuleNotFoundError ```bash # 解决方案：安装缺失的包 pip install 缺失的包名 ``` ### 问题2：FFmpeg找不到 ```python # 解决方案：指定FFmpeg路径 import ffmpeg ffmpeg_path = "C:/ffmpeg/bin/ffmpeg.exe" stream = ffmpeg.input('audio.mp3', ss=ffmpeg_path) ``` ### 问题3：权限错误 ```bash # 解决方案：以管理员身份运行命令行 # 或使用虚拟环境 ``` ## 9. 硬件连接说明 | 硬件设备 | 连接方式 | 驱动需求 | |----------|----------|----------| | PLC控制器 | USB转串口/以太网 | 串口驱动 | | 音频输入 | 3.5mm音频接口/USB麦克风 | 系统自带 | | 灯光设备 | 继电器/DMX控制器 | 根据设备而定 | ## 总结 要运行这个舞台灯光系统的Python程序，你需要： 1. **基础环境**：Python 3.7+ + 代码编辑器 2. **核心库**：ffmpeg-python, numpy, pyserial 3. **FFmpeg工具**：独立的FFmpeg可执行文件 4. **硬件驱动**：PLC通信所需的串口驱动 推荐使用**Anaconda**管理环境，**VS Code**编写代码，这样可以避免很多环境配置问题。按照上述步骤配置完成后，就可以正常运行音乐灯光律动系统了！