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

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

在网上上看到一个酷炫的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...

这是就会陷入自我怀疑，再然后 删除-重装-再删除-再重装的循环中。

别问，问就是环境玄学！
据路边社统计，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环境。

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

安装uv

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

Windows 电脑安装uv

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

Mac&Linux 电脑安装uv

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

或者：

# On macOS and Linux.
wget -qO- https://astral.sh/uv/install.sh | sh

验证安装成功

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

其他安装方式

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

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

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

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

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

或者

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

uv 常用命令

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

• 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项目更加的得心应手。

无法访问Github？

如果无法访问Github的话，我已经准备好Windows和Mac最新的安装包啦！评论区领取~

右护法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，如果出现以下信息，说明安装成功：

如果无法访问Github的话，我已经准备好安装包啦！评论区领取~

Mac&Linux 电脑安装nvm

参考 https://github.com/nvm-sh/nvm 的安装指导，进行安装。

命令行执行：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | 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版本

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

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

其他配置

建议设置为阿里源，提高下载速度：

# 设置为阿里源
npm config set registry https://registry.npmmirror.com

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

其实玩转AI，真的不难。

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

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

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

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

祝你的AI之旅，从此一路绿灯，狂飙突进。