引言
欢迎来到LangChain项目的本地开发环境搭建与代码提交指南。本指南旨在帮助开发者快速上手LangChain项目，并进行本地开发和提交代码。本文将介绍如何配置本地环境、安装依赖、运行测试及格式化代码。无论你是初学者还是经验丰富的开发者，本指南都能为你提供实用的信息和指导。
主要内容
1. 安装依赖管理工具Poetry
LangChain项目使用Poetry作为依赖管理工具。首先，需要确保安装了Poetry（版本1.7.1+）。如果你使用Conda作为环境管理器，建议先创建并激活一个新的Conda环境：
conda create -n langchain python=3.9
conda activate langchain
安装Poetry后，需告知Poetry使用虚拟环境的Python：
poetry config virtualenvs.prefer-active-python true
2. 项目结构与依赖安装
LangChain项目包含多个子包，每个子包都有独立的开发环境。对于快速入门，我们建议从langchain-community子包开始：
cd libs/community
poetry install --with lint,typing,test,test_integration
安装依赖后，可以运行测试来验证安装是否成功：
make test
3. 常见问题与解决方案
在安装过程中，如果遇到WheelFileValidationError错误，可能是由于Poetry版本过低导致的。请确保使用的是Poetry 1.6.1+版本。如果问题仍然存在，可以尝试禁用"modern installation"：
poetry config installer.modern-installation false
poetry install --with lint,typing,test,test_integration
4. 本地开发与测试
为了保证代码质量，我们建议在提交代码之前进行单元测试、集成测试以及代码覆盖率测试。以下是运行单元测试的命令：
make test
如果你只开发langchain_core或langchain_experimental子包，可以分别进入相应目录并安装相应依赖进行测试：
cd libs/core
poetry install --with test
make test
cd libs/experimental
poetry install --with test
make test
5. 代码格式化与Lint检查
提交代码之前，请确保代码通过格式化和Lint检查。格式化和Lint检查可以通过以下命令完成：
# 格式化代码
make format
# Lint检查
make lint
# 检查当前分支修改文件
make format_diff
make lint_diff
6. 拼写检查
项目中的拼写错误可以通过codespell工具进行检查和修复：
# 检查拼写错误
make spell_check
# 修复拼写错误
make spell_fix
如果codespell错误地标记了一个单词，你可以将其添加到pyproject.toml文件中的忽略列表里。
7. Jupyter Notebook支持
如果你需要添加Jupyter Notebook示例，需要安装开发依赖：
poetry install --with dev
poetry run jupyter notebook
在虚拟环境中安装LangChain后，可以在Notebook中导入和使用新逻辑。
参考资料
结束语
如果这篇文章对你有帮助，欢迎点赞并关注我的博客。您的支持是我持续创作的动力！
---END---
