通过uv创建langchain项目以及运行git项目步骤

通过uv在本地创建一个简单的langchain项目

主要用到的命令有下面这些:

1. 进入项目文件夹langchtest, 在执行下面的命令,初始化uv环境
   初始化uv环境的时候并指定了python解释器版本

   uv init --python 3.11
   

2. 修改pyproject.toml文件, 让项目使用国内镜像源

   # 项目基础信息
   [project]
   name = "your-project-name"
   version = "0.1.0"
   requires-python = ">=3.11,<3.12"
   dependencies = []
   
   # uv 全局配置（仅给 uv add 使用）
   [tool.uv]
   index-url = "https://mirrors.aliyun.com/pypi/simple/"
   

3. 运行创建uv虚拟环境命令
   创建虚拟环境的时候会自动读取pyproject.toml的Python版本要求

   uv venv
   # 运行过结果如下所示:

   

4. 激活当前uv虚拟环境

   .\.venv\Scripts\activate

   激活成功之后入下所示:
   

   备注: 退出当前激活的uv虚拟环境的命令

   deactivate

   

5. 然后就可以安装langchain了

   uv add langchain

   至此已经基本安装了一个langchain项目.

如何运行从Git上下载的用uv init初始化的项目

1. 步骤 1：进入项目目录（必做）

   cd D:\projects\你下载的项目名

2. 步骤 2：创建并激活虚拟环境（核心）
   uv 项目会通过pyproject.toml指定 Python 版本，执行以下命令自动匹配版本并创建环境：

   # 1. 创建虚拟环境（自动读取pyproject.toml的Python版本要求）
   uv venv
   
   # 2. 激活虚拟环境（Windows PowerShell）
   .venv\Scripts\Activate
   
   # 激活虚拟环境（Mac/Linux）
   source .venv/bin/activate

   激活成功标志：终端提示符开头出现(.venv)或项目名前缀。

3. 步骤 3：安装项目依赖（关键）
   下载的项目会在pyproject.toml中定义依赖，执行以下命令一键安装所有依赖：

   # 方式1：推荐（基于pyproject.toml安装，适配uv）
   uv sync
   
   # 方式2：兼容pip（如果项目有requirements.txt）
   uv pip install -r requirements.txt

• uv sync：uv 的专属命令，会严格按照pyproject.toml和uv.lock（如果有）安装依赖，确保版本一致；
• 如果项目没有uv.lock，uv sync会自动生成，保证依赖版本可复现。

4. 步骤 4：运行项目（根据项目入口文件）
   找到项目的启动文件（通常是main.py/app.py），执行：

   # 直接运行
   python main.py
   
   # 或用uv run（无需手动激活环境也能运行）
   uv run main.py