2. Python开发环境与项目初始化

本章将引导你完成从零搭建专业的数据分析与可视化开发环境。一个稳定、隔离的开发环境是后续所有项目实践的基础，能够有效避免包版本冲突，确保代码的可复现性。

2.1 环境搭建总览

本课程采用 Anaconda 作为 Python 发行版与包管理器，PyCharm 或 VS Code 作为集成开发环境（IDE）。整体架构如下图所示：

2.2 安装 Anaconda

Anaconda 是一个开源的 Python 发行版，内置了 conda 包管理器、Python 解释器以及超过 1500 个科学计算包。推荐从 清华大学开源软件镜像站 下载最新版本，以获得更快的下载速度。

操作系统	下载版本	安装注意事项
Windows	Anaconda3-2024.10-1-Windows-x86_64.exe	勾选“Add Anaconda3 to my PATH environment variable”
macOS	Anaconda3-2024.10-1-MacOSX-arm64.pkg	使用默认安装路径，避免使用 sudo
Linux	Anaconda3-2024.10-1-Linux-x86_64.sh	运行 bash Anaconda3-*.sh，按提示完成安装

2.3 配置虚拟环境

虚拟环境可以为每个项目创建独立的 Python 运行空间，避免不同项目间的依赖冲突。本课程统一使用名为 env_pyecharts 的虚拟环境。

2.3.1 创建虚拟环境

# 创建 Python 3.10 版本的虚拟环境
conda create -n env_pyecharts python=3.10 -y

2.3.2 激活与退出环境

# 激活环境（Windows）
conda activate env_pyecharts

# 激活环境（macOS / Linux）
source activate env_pyecharts

# 退出当前环境
conda deactivate

2.3.3 环境管理常用命令

命令	说明
conda env list	列出所有虚拟环境
conda remove -n env_name --all	删除指定虚拟环境
conda env export > environment.yml	导出当前环境配置
conda env create -f environment.yml	从配置文件创建环境

2.4 安装核心库

激活 env_pyecharts 环境后，依次安装本课程所需的核心库。推荐优先使用 conda 安装，若 conda 源中无对应包，再使用 pip 安装。

# 激活环境
conda activate env_pyecharts

# 安装 pandas（数据处理）
conda install pandas -y

# 安装 pyecharts（图表生成）
pip install pyecharts

# 安装 numpy（数值计算）
conda install numpy -y

# 安装 jupyter（交互式开发，可选）
conda install jupyter -y

2.4.1 核心库版本验证

安装完成后，通过以下 Python 代码验证各库是否可用：

import pandas as pd
import numpy as np
import pyecharts

print(f"pandas 版本: {pd.__version__}")
print(f"numpy 版本: {np.__version__}")
print(f"pyecharts 版本: {pyecharts.__version__}")

2.5 使用 PyCharm 创建项目

PyCharm 是 JetBrains 出品的专业 Python IDE，社区版（Community）免费且功能完整。以下为项目创建流程：

1. 新建项目： 启动 PyCharm → File → New Project。
2. 选择解释器： 在 Base interpreter 下拉菜单中，选择 Previously configured interpreter → 点击 Add Interpreter → Conda Environment → Existing environment → 选择 env_pyecharts。
3. 设置项目路径： 指定项目存放目录，例如 D:/Projects/PythonEChartsReport。
4. 创建项目： 点击 Create，PyCharm 将自动加载虚拟环境中的包。

2.6 使用 VS Code 创建项目

VS Code 是轻量级、高度可扩展的代码编辑器。配置步骤如下：

1. 安装 Python 扩展： 打开 VS Code → 点击左侧扩展图标 → 搜索 Python（由 Microsoft 发布）→ 点击 Install。
2. 打开项目文件夹： File → Open Folder → 选择或新建项目目录。
3. 选择 Python 解释器： 按 Ctrl+Shift+P（macOS: Cmd+Shift+P）→ 输入 Python: Select Interpreter → 选择 env_pyecharts 环境。
4. 创建并运行测试文件： 新建 test_env.py，输入 import pandas; print(pandas.__version__)，按 Ctrl+F5 运行。

2.7 环境验证与测试

完成上述步骤后，执行以下综合测试脚本，确保所有组件正常工作：

# test_environment.py
import sys
import pandas as pd
import numpy as np
import pyecharts

print("=" * 40)
print("Python 版本:", sys.version)
print("pandas 版本:", pd.__version__)
print("numpy 版本:", np.__version__)
print("pyecharts 版本:", pyecharts.__version__)
print("=" * 40)

# 测试 pandas 基本功能
data = {'城市': ['北京', '上海', '广州'], 'GDP': [40000, 38000, 28000]}
df = pd.DataFrame(data)
print("\nDataFrame 测试：")
print(df)

# 测试 pyecharts 基本功能
from pyecharts.charts import Bar
from pyecharts import options as opts

bar = (
    Bar()
    .add_xaxis(["北京", "上海", "广州"])
    .add_yaxis("GDP (亿元)", [40000, 38000, 28000])
    .set_global_opts(title_opts=opts.TitleOpts(title="城市 GDP 测试"))
)
bar.render("test_chart.html")
print("\n✅ 测试图表已生成：test_chart.html")

2.8 常见问题与解决方案

问题现象	可能原因	解决方案
conda: command not found	Anaconda 未添加到 PATH	重新安装并勾选“Add to PATH”，或手动添加环境变量
ImportError: No module named 'pyecharts'	未在正确的虚拟环境中安装	执行 conda activate env_pyecharts 后重新安装
PyCharm 无法识别 Conda 环境	PyCharm 未正确配置解释器	在 Settings → Project → Python Interpreter 中手动添加
VS Code 终端无法激活环境	终端未继承 VS Code 的 Python 环境	使用 Ctrl+Shift+` 打开新终端，或手动执行 conda activate