Python 3.8 与 LangChain 安装指南
📋 本文目录
一、前言
1.1 为什么需要Python 3.8？
LangChain 0.1.x 版本对 Python 版本有特定要求，Python 3.8 是兼容性最好的版本，确保：
-
✅ 依赖包稳定
-
✅ 不出现版本冲突
-
✅ 社区支持完善
1.2 本文目标
本文将帮你完成：
-
环境检查
-
Python 3.8 配置
-
虚拟环境创建
-
依赖包安装
-
环境验证
二、环境要求检查
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：
第一步：下载
-
滚动到页面底部，找到
Windows installer (64-bit) -
点击下载这个文件（文件名类似
python-3.8.10-amd64.exe）
第二步：安装
-
双击下载的安装文件
-
重要！ 勾选底部的 "Add Python 3.8 to PATH"
-
点击 "Install Now" 开始安装
-
等待安装完成，看到 "Setup was successful" 就可以了
第三步：验证 打开新的命令行窗口，输入：
py -3.8 --version你应该看到：
Python 3.8.103.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\activateWindows PowerShell：
.\venv_py38\Scripts\Activate.ps1Linux/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 常见问题列表
|
问题 |
症状 |
解决方案 |
|---|---|---|
|
|
输入 |
重新安装Python 3.8，一定要勾选 "Add to PATH"，安装后重启命令行 |
|
找不到 Python 3.8 |
|
检查是否正确安装了 Python 3.8，参考3.1节 |
|
pip下载慢 |
安装依赖时进度条不动或很慢 |
配置国内镜像源（参考5.3节） |
|
依赖安装失败 |
报错 "Permission denied" 或其他错误 |
1. 尝试更新pip： |
|
导入错误 |
运行代码时提示 "No module named ..." |
确保虚拟环境已经激活（命令行前有 |
|
PowerShell脚本无法运行 |
提示"无法加载，因为在此系统上禁止运行脚本" |
1. 以管理员身份打开PowerShell 2. 运行 |
7.2 如何获得帮助？
如果你遇到了文章里没提到的问题：
-
仔细阅读错误信息，通常错误信息里会有提示
-
把错误信息复制到搜索引擎里搜索，可能已经有人遇到过同样的问题
-
在相关技术社区（比如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 重要提醒：每次开发前要做的事
-
打开命令行
-
进入项目目录：
cd e:\AI\LangChain_path -
激活虚拟环境：
venv_py38\Scripts\activate -
开始你的开发！
📚 参考资源
|
资源 |
链接 |
|---|---|
|
Python 3.8 官方下载 |
|
|
Python 虚拟环境文档 |
|
|
LangChain 官方文档 |
https://python.langchain.com/v0.1/docs/get_started/introduction.html |
|
清华大学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使用方法
-
双击运行
setup_env.bat -
等待自动完成
-
脚本会自动检查、安装并验证环境
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
18
0- 0
已为社区贡献7条内容
所有评论(0)