Node 与 Python 环境安装指南

要解决什么问题

本地开发里，Node.js 与 Python 往往版本不对、PATH 混乱，或装完 node/python3 仍跑不通项目脚本。不同系统（macOS、Linux 发行版、Windows）安装路径和包管理器差异大；在国内网络下，官方源还常拖慢或失败。你需要的是可核对、可复现的环境，而不是零散复制几条 wget/curl 命令。

技能如何工作

本技能把安装流程拆成固定原则与分平台参考文档：

1. 先检测环境：确认操作系统（如 uname -s、PowerShell 的 $env:OS）以及是否已有 Node/Python。
2. 优先版本管理工具：Node 侧推荐 nvm；Python 侧推荐 pyenv 或 conda，便于多版本并存。
3. 完整命令序列：按平台给出可直接执行的步骤，并附带验证（如 node -v、npm -v、python3 --version、pip3 --version）。
4. 国内镜像：默认考虑镜像加速，减少拉包失败。

遇到权限、PATH、多版本冲突等问题时，会引导查阅 troubleshooting.md，而不是盲目重试安装。

适用边界与注意点

• 技能侧重安装与基础验证，不替代具体项目的虚拟环境策略（如某仓库锁定的 Node 版本、Poetry/pnpm 工作流）。
• 平台细节以 nodejs-install.md、python-install.md 为准；Agent 需按用户 OS 选用对应章节。
• 企业内网、容器内或已统一由 IT 下发运行时，应先确认是否允许自行安装版本管理器。