环境配置不是技术,而是生产力。
你是不是也有过这样的经历?
在网上上看到一个酷炫的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
推荐一个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>安装指定版本的Nodenvm 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之旅,从此一路绿灯,狂飙突进。