在mac电脑上配置python uv环境,核心步骤是安装uv二进制文件、初始化项目并管理虚拟环境。具体做法是通过homebrew或官方脚本安装uv,使用uv init创建项目结构,并通过uv venv生成隔离的虚拟环境。这样做的结果是获得一个快速、独立的python运行空间,且无需手动激活即可通过uv run直接执行代码。若系统已存在全局python包,uv会自动忽略它们以确保环境纯净。

如何安装uv并确保其可用
安装uv最简单的方式是使用macOS自带的Homebrew包管理器。打开终端并执行brew install uv命令,安装完成后验证版本即可确认配置成功。这一步解决了工具本身的获取问题,为后续的项目管理打下基础。

brew install uv uv --version
执行上述命令后,终端应输出类似uv 0.4.30的版本信息,表明uv已正确安装并可被系统调用。如果之前使用过pip安装过其他包管理工具,建议卸载以避免路径冲突。
如何初始化项目并创建虚拟环境
初始化项目时,uv init会创建一个包含pyproject.toml的基础目录结构。随后使用uv venv在当前目录下生成名为.venv的虚拟环境文件夹。这个环境独立于系统Python,所有依赖都将安装在此处,避免污染全局环境。
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。

mkdir my_project cd my_project uv init uv venv
运行uv init后,当前目录会出现main.py和pyproject.toml文件。接着运行uv venv,会在同级目录下生成.venv文件夹。此时环境已就绪,可以直接使用uv add安装依赖,例如uv add requests会将requests库安装到该虚拟环境中,并在pyproject.toml中记录依赖关系。
基于uv run命令的具体执行方式
在使用uv run执行脚本时,程序会自动激活当前项目的虚拟环境并加载已安装的依赖,无需手动source激活脚本。这种机制简化了开发流程,确保每次运行都使用正确的依赖版本。例如,在项目根目录下运行uv run main.py,uv会查找.venv中的Python解释器并执行脚本。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










