Mac nodejs安装及环境配置

### macOS 上安装 Node.js 并配置开发环境

#### 下载 Node.js
对于希望在 macOS 上建立 Node.js 开发环境的开发者来说，可以从官方网址获取最新稳定版(LTS) 的 Node.js。通过浏览器访问 [https://nodejs.org/en/download](https://nodejs.org/en/download)，可以找到适合操作系统的安装包[^2]。

#### 使用 Homebrew 安装 Node.js
除了直接从官方网站下载安装文件外，在 macOS 中还可以利用 Homebrew 来简化软件管理流程。Homebrew 是一款非常流行的 macOS 软件包管理系统。如果尚未安装 Homebrew，则可以通过终端执行以下命令来完成安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

一旦有了 Homebrew 工具，只需一条简单的指令即可轻松部署 Node.js 及其依赖项：

brew install node

此方法不仅能够快速设置好运行时环境，还便于后续更新维护工作[^1]。

#### 创建 Yarn 命令链接
为了方便全局调用 yarn 包管理工具，建议创建指向本地已安装路径下的快捷方式。具体做法是在 Terminal 终端内输入如下所示的命令行语句：

sudo ln -s ~/nodejs/bin/yarn /usr/local/bin/

这条命令的作用在于让系统识别到自定义目录中的可执行程序，并将其加入 PATH 环境变量以便随时调用。

#### 解决特定版本兼容性问题
当遇到某些项目或库仅支持较旧版本的 Node.js 时（例如 truffle 和 drizzle），可能需要降级至指定版本以确保正常运作。针对此类情况，推荐采用 nvm (Node Version Manager) 实现多版本共存方案。nvm 提供了一套便捷机制用于切换不同版本间的无缝衔接，从而有效规避因 API 更改带来的潜在冲突风险。

首先按照指引安装 nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.zshrc # 或者 source ~/.bash_profile 如果使用的是 Bash Shell
command -v nvm # 验证是否成功加载 NVM 函数

接着可以根据实际需求安装所需的 Node.js 版本号，比如 v12.18.4：

nvm install 12.18.4

最后确认当前使用的 Node.js 是否为预期版本：

node -v

以上步骤有助于解决由于高版本引起的编译错误等问题，特别是像 scrypt 库这样的第三方模块可能会受到底层实现差异的影响而无法顺利构建[^3]。