> 环境配置不是技术，而是生产力。

你是不是也有过这样的经历？

在网上上看到一个酷炫的MCP，或者一个实用的Skill，再或者在GitHub发现了一个能自动化处理文档的AI Agent项目，简介写着“五分钟快速上手”。

你兴奋地打开终端输入claude、或者打开Cursor，克隆代码，复制粘贴，执行。

接下来，迎接你的不是`success`，而是一屏你看不懂的红色：`Node.js version must be >= 18.15.0`

或者更经典的 `ERROR: Could not find a version that satisfies the requirement...`

这是就会陷入自我怀疑，再然后 `删除-重装-再删除-再重装`的循环中。
![#left](https://developer.qcloudimg.com/http-save/yehe-11350454/1a7d9616fd4aa40e7b15b7af01018e28.png)

别问，问就是环境玄学！
据路边社统计，87%的AI开发者每天有2小时在和`Error: command not found`斗智斗勇。

而今天的主角——uv和nvm，就是专治各种不服的赛博华佗，是你在AI Agent开发中的`左右护法`。

# 左护法uv：Python的“乾坤大挪移”

Python 是当之无愧的 "AI核心发动机" 。从机器学习库、大语言模型调用，到数据分析和自动化脚本，几乎一切AI的重度任务都离不开Python。所以，轻松+愉快的使用Python，是每个AI开发者的必修课。

但Python的世界，有个著名的坑，叫做 “pip地狱” ：用 pip 安装包慢如蜗牛；项目A需要的TensorFlow 2.8和项目B需要的TensorFlow 2.12水火不容；更别提“在我电脑上好好的，到你那就运行不了”的千古难题。

已经2026年了，这里也就不再推荐使用传统的`venv`了，直接一步到胃，用uv来管理Python环境。

![#left](https://developer.qcloudimg.com/http-save/yehe-11350454/6cc5aceac0f9c2a2e58358474760fb3d.png)

https://github.com/astral-sh/uv

## 安装uv

> 重要提醒：如果已经通过其他方式安装了Python，建议是卸载掉，统一由uv来管理。

### Windows 电脑安装uv

```bash
# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

### Mac&Linux 电脑安装uv
```bash
# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh
```
或者：
```bash
# On macOS and Linux.
wget -qO- https://astral.sh/uv/install.sh | sh
```

### 验证安装成功

打开命令行，输入`uv --version`，如果出现以下信息，说明安装成功。

![#left](https://developer.qcloudimg.com/http-save/yehe-11350454/18f69b743323dfca2b625d71499b51e0.png)

## 其他安装方式

- 到 https://github.com/astral-sh/uv/releases 下载适合自己电脑的压缩包

![#left](https://developer.qcloudimg.com/http-save/yehe-11350454/86c859307967fbbc1dd4a11a17dfbb9e.png)

- 解压压缩包，会得到`uv` 、`uvw`、`uvx` 三个文件

![#left](https://developer.qcloudimg.com/http-save/yehe-11350454/4ecbe006d9ffb4ae8161b130966f28fa.png)

- 配置解压目录为环境变量（Windows）

![#left](https://developer.qcloudimg.com/http-save/yehe-11350454/5bd468cf6cb5199c5bca2ea185509232.png)

- Mac & Linux 电脑配置解压目录为环境变量（/usr/local/sofe/uv需要替换为你解压后的的uv目录）

```bash
echo 'export PATH="$PATH:/usr/local/sofe/uv"' >> ~/.zshrc
source ~/.zshrc
```
或者

```bash
echo 'export PATH="$PATH:/usr/local/sofe/uv"' >> ~/.bashrc
source ~/.bashrc
```

## uv 常用命令

- `uv python list` 列出所有可用的Python版本
- `uv python install <version>` 安装指定版本的Python

![#left](https://developer.qcloudimg.com/http-save/yehe-11350454/738818f7d0a968d40f1d1958aa362fda.png)

- `uv run test.py` 运行test.py

- 所有命令请查看 https://docs.astral.sh/uv/reference/cli/

## 推荐一个uv官方出的Claude Code 的skill
https://github.com/astral-sh/claude-code-plugins

配置上这个插件后，Claude Code 管理Python项目更加的得心应手。


# 右护法nvm：Node.js的“影分身之术”

想象一下这个场景：你家里要来三位客人。

客人A只喝凉白开（Node.js 16），客人B非要喝82年的拉菲（Node.js 18），客人C是个健身狂魔，只喝最新款的电解质水（Node.js 22）。

而你，只有一个杯子（一台电脑）。

这时候，nvm就像一个神奇的调酒师，可以瞬间切换不同版本的Node.js，让你轻松满足每一位客人的需求，而无需重新安装或配置环境。

不废话，直接上手。

## 安装nvm

> 重要提醒：安装前务必先卸载电脑上已安装的 `Node.js`

### Windows 电脑安装nvm
到 https://github.com/coreybutler/nvm-windows 下载`nvm-setup.exe`，然后一路点点点，就安装成功啦。
安装成功后，打开`cmd`，输入`nvm`，如果出现以下信息，说明安装成功：
![1-win-nvm-install-success.png#left](https://developer.qcloudimg.com/http-save/yehe-11350454/7377821c53229d4e6b5dbb1244efd712.png)

### Mac&Linux 电脑安装nvm
参考 https://github.com/nvm-sh/nvm 的安装指导，进行安装。

命令行执行：
```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
```
或者：
```bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
```
如果无法访问Github，我已经准备了最新版的离线安装包，评论区领取~

手动离线安装包安装流程：
- 下载离线安装包
- 解压压缩包
- 当前目录进入命令行
- 执行命令：`chmod +x install_nvm.sh && ./install_nvm.sh`


## nvm 常用命令

- `nvm list` 列出电脑已经安装的Node版本
- `nvm list available` 列出所有可下载的Node版本

![2-win-nvm-list.png#left](https://developer.qcloudimg.com/http-save/yehe-11350454/518fa6324e11b78cf6478730c42df156.png)

- `nvm install <version>` 安装指定版本的Node
- `nvm uninstall <version>` 卸载指定版本的Node

![#left](https://developer.qcloudimg.com/http-save/yehe-11350454/b160c6f7d9fc14f52599e2a3c1aa2eaf.png)

- `nvm use <version>` 切换到指定版本的Node

![#left](https://developer.qcloudimg.com/http-save/yehe-11350454/fa4fa2ca41332d6f7e901b578885b6a6.png)

## 其他配置

建议设置为阿里源，提高下载速度：
```bash
# 设置为阿里源
npm config set registry https://registry.npmmirror.com
```


# 总结环境管理是AI开发的「元技能」

其实玩转AI，真的不难。

你不用懂复杂的编程语言，不用记一堆命令行，不用反复卸载重装，只要找对工具，学会“偷懒”，就能轻松上手。

uv和nvm这两个工具，看似复杂，实则超级简单，核心就是帮我们“省去无效操作、避免报错、提升效率”，新手只要记住几个核心命令，用到的时候翻出来抄，你就搞定了使用AI的两个环境（Python和NodeJS）管理问题 。

配置环境不是目的，而是为了让你更专注于创造——就像修好汽车引擎，才能驰骋AI的星辰大海。

你被环境配置坑得最惨的一次经历是什么？或者，你最想用AI Agent帮你自动搞定什么麻烦事？评论区唠唠，或许下次我就帮你写写怎么实现它！

在网上上看到一个酷炫的MCP，或者一个实用的Skill，再或者在GitHub发现了一个能自动化处理文档的AI Agent项目，简介写着“五分钟快速上手”。

搞定这两个工具，让你玩转AI的效率翻倍！

配置环境不是目的，而是为了让你更专注于创造——就像修好汽车引擎，才能驰骋AI的星辰大海。

全栈

人工智能

后端

开发工具

uv和nvm是AI开发者必备的环境管理工具，uv解决Python版本冲突问题，nvm管理Node.js多版本切换。uv提供极速包安装和隔离环境，nvm支持一键切换Node版本，两者都能大幅提升开发效率。掌握这两个工具，让开发者告别环境配置困扰，专注AI项目开发。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

搞定这两个工具，让你玩转AI的效率翻倍！-腾讯云开发者社区-腾讯云

搞定这两个工具，让你玩转AI的效率翻倍！

搞定这两个工具，让你玩转AI的效率翻倍！

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐