📋 本文目录

• 一、前言

• 二、环境要求检查

• 三、Python 3.8 配置

• 四、虚拟环境创建

• 五、依赖安装

• 六、验证与测试

• 七、常见问题排查

• 八、总结与下一步

• 附录：一键安装脚本

---

一、前言

1.1 为什么需要Python 3.8？

LangChain 0.1.x 版本对 Python 版本有特定要求，Python 3.8 是兼容性最好的版本，确保：

• ✅ 依赖包稳定

• ✅ 不出现版本冲突

• ✅ 社区支持完善

1.2 本文目标

本文将帮你完成：

1. 环境检查

2. Python 3.8 配置

3. 虚拟环境创建

4. 依赖包安装

5. 环境验证

---

二、环境要求检查

2.1 系统要求

组件	最低要求	推荐配置
操作系统	Windows 10	Windows 10+
内存	4GB	8GB+
磁盘空间	2GB	5GB+

2.2 检查已有Python版本

第一步：打开命令行

按 Win + R 键，输入 cmd，然后按回车，你会看到一个黑色的窗口。

第二步：查看已安装的Python

在黑色窗口里输入：

py -0p

你会看到类似这样的输出：

 -V:3.14 *
 -V:3.8

说明：

• -V:3.14 * 表示当前默认是 Python 3.14（星号标记）

• -V:3.8 表示你已经安装了 Python 3.8（太棒了！）

如果你没有看到 -V:3.8，那么需要先安装 Python 3.8。

---

三、Python 3.8 配置

3.1 下载安装Python 3.8（如果需要）

如果系统没有Python 3.8：

第一步：下载

1. 访问 Python 3.8.10 官网下载页

2. 滚动到页面底部，找到 Windows installer (64-bit)

3. 点击下载这个文件（文件名类似 python-3.8.10-amd64.exe）

第二步：安装

1. 双击下载的安装文件

2. 重要！ 勾选底部的 "Add Python 3.8 to PATH"

3. 点击 "Install Now" 开始安装

4. 等待安装完成，看到 "Setup was successful" 就可以了

第三步：验证 打开新的命令行窗口，输入：

py -3.8 --version

你应该看到：

Python 3.8.10

3.2 验证Python 3.8

让我们确认一下 Python 3.8 是否可用：

py -3.8 --version

正常输出：

Python 3.8.10

如果有问题，请参考后面的【常见问题排查】部分。

---

四、虚拟环境创建

4.1 什么是虚拟环境？为什么要用？

优势	说明
隔离性	避免版本冲突，不影响你电脑的其他Python项目
可复制	方便团队协作，别人也能用一样的环境
可清理	随时删除重建，不影响系统

简单理解： 虚拟环境就像给你的项目准备了一个独立的小房间，里面的东西不会跟外面混在一起。

4.2 创建项目目录

首先，我们需要一个地方来放我们的项目文件：

# 创建项目目录（如果还没有）
mkdir e:\AI\LangChain_path

# 进入这个目录
cd e:\AI\LangChain_path

提示： 你也可以选择其他位置，比如 D:\LangChain，但要记得路径里不要有中文和空格。

4.3 创建虚拟环境

在项目目录下运行：

# 使用Python 3.8创建虚拟环境，名字叫 venv_py38
py -3.8 -m venv venv_py38

这会创建一个名为 venv_py38 的文件夹，里面包含了虚拟环境的所有文件。

4.4 激活虚拟环境

重要！ 每次打开新的命令行窗口，都需要激活虚拟环境！

Windows CMD（推荐）：

venv_py38\Scripts\activate

Windows PowerShell：

.\venv_py38\Scripts\Activate.ps1

Linux/Mac：

source venv_py38/bin/activate

激活成功后，你会看到命令行前面有 (venv_py38) 标记：

(venv_py38) e:\AI\LangChain_path>

4.5 验证虚拟环境

在激活的虚拟环境里，检查一下Python版本：

python --version

应该输出 Python 3.8.10：

Python 3.8.10

---

五、依赖安装

5.1 创建 requirements.txt

在项目目录 e:\AI\LangChain_path 里，创建一个名为 requirements.txt 的文件，内容如下：

langchain==0.1.20
langchain-openai==0.1.7
langchain-core==0.1.52
langchain-community==0.0.38
python-dotenv==1.0.1

小贴士： 你可以用记事本创建这个文件，保存时文件名选 requirements.txt，编码选 UTF-8。

5.2 使用requirements.txt安装

确保你在项目目录下，并且虚拟环境已经激活，然后运行：

pip install -r requirements.txt

这会自动下载并安装所有需要的依赖包，请耐心等待...

5.3 （可选）配置国内镜像源，加速下载

如果你发现下载速度很慢，可以配置清华大学的镜像源：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

然后再次运行安装命令。

---

六、验证与测试

6.1 创建环境验证脚本

让我们创建一个验证脚本 check_env.py：

import sys
import importlib

print("=" * 60)
print("  LangChain 环境检查")
print("=" * 60)

# 检查Python版本
print(f"\n[1/5] 检查Python版本...")
print(f"当前Python版本: {sys.version}")
if sys.version_info.major == 3 and sys.version_info.minor == 8:
    print("[OK] Python 3.8 ✓")
else:
    print("[ERROR] 需要Python 3.8！")
    sys.exit(1)

# 检查各个包
packages = [
    ("langchain", "LangChain 核心"),
    ("langchain_openai", "LangChain OpenAI"),
    ("langchain_core", "LangChain Core"),
    ("langchain_community", "LangChain Community"),
]

print(f"\n[2/5] 检查依赖包...")
all_ok = True

for pkg_name, pkg_desc in packages:
    try:
        pkg = importlib.import_module(pkg_name)
        version = getattr(pkg, "__version__", "未知版本")
        print(f"[OK] {pkg_desc}: {version} ✓")
    except ImportError as e:
        print(f"[ERROR] {pkg_desc}: 未安装！ {e}")
        all_ok = False

if not all_ok:
    print("\n有些包没有安装成功，请重新运行安装命令！")
    sys.exit(1)

print(f"\n[3/5] 所有依赖包检查通过！")

print(f"\n[4/5] 测试基本功能...")
try:
    from langchain_core.tools import tool
    
    @tool
    def test_tool(x: int) -> int:
        """测试工具"""
        return x * 2
    
    result = test_tool.invoke({"x": 5})
    print(f"[OK] 工具功能正常: 5 * 2 = {result} ✓")
except Exception as e:
    print(f"[ERROR] 测试失败: {e}")
    all_ok = False

print(f"\n[5/5] 环境检查完成！")
print("=" * 60)
if all_ok:
    print("\n🎉 恭喜！你的LangChain环境已经搭建完成！")
else:
    print("\n❌ 还有一些问题需要解决，请检查上面的错误信息。")
print("=" * 60)

6.2 运行验证脚本

在命令行里运行：

py -3.8 check_env.py

如果一切正常，你会看到：

============================================================
  LangChain 环境检查
============================================================

[1/5] 检查Python版本...
当前Python版本: 3.8.10 (...)
[OK] Python 3.8 ✓

[2/5] 检查依赖包...
[OK] LangChain 核心: 0.1.20 ✓
[OK] LangChain OpenAI: 0.1.7 ✓
[OK] LangChain Core: 0.1.52 ✓
[OK] LangChain Community: 0.0.38 ✓

[3/5] 所有依赖包检查通过！

[4/5] 测试基本功能...
[OK] 工具功能正常: 5 * 2 = 10 ✓

[5/5] 环境检查完成！
============================================================

🎉 恭喜！你的LangChain环境已经搭建完成！
============================================================

---

七、常见问题排查

7.1 常见问题列表

问题	症状	解决方案
py 命令找不到	输入 py 提示"不是内部或外部命令"	重新安装Python 3.8，一定要勾选 "Add to PATH"，安装后重启命令行
找不到 Python 3.8	py -3.8 提示找不到	检查是否正确安装了 Python 3.8，参考3.1节
pip下载慢	安装依赖时进度条不动或很慢	配置国内镜像源（参考5.3节）
依赖安装失败	报错 "Permission denied" 或其他错误	1. 尝试更新pip：python -m pip install --upgrade pip 2. 检查网络连接 3. 可以尝试一个个安装：pip install langchain==0.1.20
导入错误	运行代码时提示 "No module named ..."	确保虚拟环境已经激活（命令行前有 (venv_py38)），然后重新安装依赖
PowerShell脚本无法运行	提示"无法加载，因为在此系统上禁止运行脚本"	1. 以管理员身份打开PowerShell 2. 运行 Set-ExecutionPolicy RemoteSigned 3. 选择 Y 确认

7.2 如何获得帮助？

如果你遇到了文章里没提到的问题：

1. 仔细阅读错误信息，通常错误信息里会有提示

2. 把错误信息复制到搜索引擎里搜索，可能已经有人遇到过同样的问题

3. 在相关技术社区（比如CSDN、GitHub Issues）提问

---

八、总结与下一步

8.1 本文要点回顾

任务	状态
✅ Python 3.8 环境	已确认安装并可用
✅ 虚拟环境	venv_py38 已创建并激活
✅ 依赖包	已安装完毕
✅ 环境验证	检查脚本运行通过

8.2 你的项目目录现在应该有这些文件：

e:\AI\LangChain_path\
├── venv_py38\          # 虚拟环境文件夹
├── requirements.txt    # 依赖列表
└── check_env.py        # 环境验证脚本

8.3 重要提醒：每次开发前要做的事

1. 打开命令行

2. 进入项目目录：cd e:\AI\LangChain_path

3. 激活虚拟环境：venv_py38\Scripts\activate

4. 开始你的开发！

---

📚 参考资源

资源	链接
Python 3.8 官方下载	https://www.python.org/downloads/release/python-3810/
Python 虚拟环境文档	https://docs.python.org/3.8/tutorial/venv.html
LangChain 官方文档	https://python.langchain.com/v0.1/docs/get_started/introduction.html
清华大学PyPI镜像	https://mirrors.tuna.tsinghua.edu.cn/help/pypi/

---

💬 互动讨论

如果在安装过程中遇到问题，欢迎在评论区留言！

点赞👍 + 收藏⭐ + 关注👀，下一篇更精彩！

---

附录：一键安装脚本

为了方便大家，我准备了一个一键安装脚本。

创建安装脚本

在项目目录下创建 setup_env.bat：

@echo off
chcp 65001 >nul
echo ============================================================
echo   LangChain 环境一键配置
echo ============================================================
echo.

echo [1/5] 检查Python 3.8...
py -3.8 --version >nul 2>&1
if errorlevel 1 (
    echo [错误] 没有找到Python 3.8！请先安装Python 3.8
    echo 参考文章3.1节下载安装
    pause
    exit /b 1
)
echo [OK] Python 3.8 已找到
echo.

echo [2/5] 创建虚拟环境...
if not exist "venv_py38" (
    py -3.8 -m venv venv_py38
    echo [OK] 虚拟环境创建完成
) else (
    echo [提示] 虚拟环境已存在，跳过创建
)
echo.

echo [3/5] 激活虚拟环境并安装依赖...
call venv_py38\Scripts\activate.bat

echo.
echo [4/5] 升级pip...
python -m pip install --upgrade pip -q

echo.
echo [5/5] 安装依赖包（可能需要几分钟，请耐心等待）...
if exist "requirements.txt" (
    pip install -r requirements.txt
) else (
    echo 创建 requirements.txt...
    (
        echo langchain==0.1.20
        echo langchain-openai==0.1.7
        echo langchain-core==0.1.52
        echo langchain-community==0.0.38
        echo python-dotenv==1.0.1
    ) > requirements.txt
    pip install -r requirements.txt
)

echo.
echo ============================================================
echo   安装完成！现在验证环境...
echo ============================================================

echo.
echo 创建验证脚本...
(
    echo import sys, importlib
    echo print("="*60^)
    echo print("  环境检查结果")
    echo print("="*60^)
    echo print("\nPython版本:", sys.version^)
    echo ok = True
    echo for name, desc in [("langchain","LangChain"^), ("langchain_openai","OpenAI"^), ("langchain_core","Core"^), ("langchain_community","Community"^)]:
    echo     try:
    echo         m = importlib.import_module(name^)
    echo         print(f"[OK] {desc}: {getattr(m,'__version__','?'^)}"^)
    echo     except:
    echo         print(f"[ERROR] {desc} 未安装"^)
    echo         ok = False
    echo print("="*60^)
    echo if ok: print("\n  环境搭建成功！"^)
    echo else: print("\n  有错误，请检查上面的信息"^)
) > check_env_simple.py

python check_env_simple.py

echo.
echo ============================================================
echo   下一步操作提示
echo ============================================================
echo.
echo 1. 每次开发前，请先运行：venv_py38\Scripts\activate
echo 2. 然后就可以开始你的 Agent 开发了！
echo.
echo 提示：你可以直接双击运行这个 setup_env.bat 来再次配置
echo.
pause

使用方法

1. 双击运行 setup_env.bat

2. 等待自动完成

3. 脚本会自动检查、安装并验证环境