📚 课程目录第4章环境搭建

4. 环境搭建：Python环境、pip工具、虚拟环境、基础依赖库安装

说实话，很多搞访问控制的同行，最后都栽在环境问题上。策略写得再漂亮，一跑就报错，那才叫尴尬。我见过太多人花了两小时调策略，结果发现是 requests 库版本不对。

这一章，咱们把地基打牢。你跟着我走一遍，后面三十章就不会被环境折腾。

4.1 Python 环境：选对版本，省一半心

我个人习惯用 Python 3.9 到 3.11 之间的版本。为什么？因为 lxml 和 pyyaml 在这些版本上最稳。Python 3.12 刚出那会儿，我踩过坑——某个依赖库还没适配，编译报错折腾了一下午。

我的建议： 直接装 Python 3.10.11。这个版本兼容性好，社区支持也最活跃。

安装步骤很简单，但有几个细节要注意：

Windows 用户： 安装时一定勾选 "Add Python to PATH"。我见过有人没勾，后面 pip 命令死活找不到。
macOS 用户： 别用系统自带的 Python 2.7，那玩意儿早淘汰了。用 brew install python@3.10。
Linux 用户： Ubuntu/Debian 用 apt install python3.10 python3.10-venv。CentOS 用 yum install python3.10。

装完后，打开终端验证一下：

python3 --version
# 输出：Python 3.10.11

嗯，看到这个版本号，就说明第一步走通了。

4.2 pip 工具：包管理器的正确用法

pip 是 Python 的包管理器。说白了，它就是帮你下载、安装、管理第三方库的工具。你想想看，如果没有 pip，你得手动去 GitHub 下载源码，然后 python setup.py install，那得多累。

新版的 Python 已经自带 pip 了。但有个坑——pip 版本太旧，下载依赖时会报错。我曾经在客户现场遇到过，pip 20.x 死活装不上 pyyaml，升级到 23.x 就好了。

先升级 pip：

python3 -m pip install --upgrade pip

升级后版本应该在 23.x 以上。

升级完，你可以用 pip list 看看当前装了哪些包。如果看到一堆乱七八糟的东西，别慌，后面我们用虚拟环境隔离。

4.3 虚拟环境：隔离是美德

为什么需要虚拟环境？我举个真实例子。你手上有两个项目：项目 A 需要 lxml 4.9，项目 B 需要 lxml 5.0。如果装在同一台机器上，冲突是必然的。虚拟环境就是给每个项目一个独立的 Python 小世界，互不干扰。

我个人习惯用 Python 自带的 venv 模块，轻量、干净、没额外依赖。

创建虚拟环境的步骤：

打开终端，进入你的项目目录。
运行：python3 -m venv venv
激活虚拟环境：
- Windows: venv\Scripts\activate
- macOS/Linux: source venv/bin/activate

激活后，你会看到终端前面多了 (venv) 字样。这就说明你已经在虚拟环境里了。这时候再装任何包，都不会污染系统全局。

  避坑指南： 我曾经在项目里忘了激活虚拟环境，直接 pip install 装了一堆包到系统里。后来换机器部署时，才发现依赖全乱套了。所以，每次开新终端，第一件事就是激活虚拟环境。

4.4 基础依赖库安装：lxml, pyyaml, requests

这三个库，是我们后面做访问控制策略自动化的核心工具。我分别说说它们的作用：

库名	作用	为什么需要它
lxml	XML/HTML 解析	很多访问控制策略（如 XACML、SAML）都是 XML 格式，lxml 能高效解析和生成
pyyaml	YAML 解析	现代策略配置（如 OPA、AWS IAM 策略）常用 YAML，pyyaml 是 Python 生态里最成熟的 YAML 库
requests	HTTP 请求	自动化配置需要调用 API（如 LDAP、SCIM、REST 接口），requests 是 Python 的 HTTP 标准答案

安装命令很简单，一行搞定：

pip install lxml pyyaml requests

如果你在国内，下载速度可能很慢。我建议配置清华镜像源：

pip install lxml pyyaml requests -i https://pypi.tuna.tsinghua.edu.cn/simple

装完后，验证一下：

python3 -c "import lxml; import yaml; import requests; print('All good!')"

如果没报错，说明三个库都装好了。

小技巧： 你可以把依赖写进 requirements.txt 文件，方便以后重复安装：

lxml==4.9.3
pyyaml==6.0.1
requests==2.31.0

然后运行 pip install -r requirements.txt 一键安装。

4.5 本章知识体系总览

下面这张图，把整个环境搭建的流程串起来了。你跟着箭头走，就不会迷路。

这张图把整个流程分成了五个步骤。你从左上角开始，顺着箭头往下走，每一步都对应我们刚才讲的内容。我特意把常见问题和关键提醒放在两侧，方便你快速查阅。

4.6 验证环境是否就绪

最后一步，写个简单的测试脚本，确保所有东西都能正常工作：

# test_env.py
import lxml
import yaml
import requests

print(f"lxml 版本: {lxml.__version__}")
print(f"pyyaml 版本: {yaml.__version__}")
print(f"requests 版本: {requests.__version__}")

# 测试 requests 能否正常发请求
r = requests.get("https://httpbin.org/get")
print(f"HTTP 请求测试: {r.status_code}")

# 测试 yaml 解析
yaml_str = """
policy:
  name: "test-policy"
  effect: "Allow"
"""
parsed = yaml.safe_load(yaml_str)
print(f"YAML 解析测试: {parsed['policy']['name']}")

# 测试 lxml 解析
xml_str = "<policy><name>test</name></policy>"
root = lxml.etree.fromstring(xml_str)
print(f"XML 解析测试: {root.find('name').text}")

print("环境搭建完成，一切正常！")

运行 python3 test_env.py，如果看到 "环境搭建完成，一切正常！"，恭喜你，环境已经就绪了。

注意： 如果 lxml 安装报错，可能是因为缺少 C 编译器。Windows 用户装 Visual C++ Build Tools，macOS 用户装 Xcode Command Line Tools，Linux 用户装 libxml2-dev libxslt1-dev。

环境搭好了，后面咱们就可以专心搞策略了。你想想看，如果每次都被环境问题绊住，那多耽误事。现在好了，一劳永逸。