← 返回博客

Mac Node.js 多版本管理:用 Devio 配置 nvm、.nvmrc 与 npm 项目


同一台 Mac 上的不同 Node.js 项目可能需要不同版本。Devio 可以选择已安装的 Node.js 运行版本、匹配项目 .nvmrc,并管理 npm 脚本、依赖安装、构建和日志。关键是把“项目绑定版本”与“终端默认版本”分开看。

适用范围与准备工作

Devio 是免费、无需注册的 Apple Silicon Mac 本地开发环境管理器,目前未开源。请从官方下载页安装,功能以当前应用和版本说明为准。

准备可信的项目目录和 package.json,先查看项目文档、engines 配置及 .nvmrc,确定需要的 Node.js 版本与启动脚本。安装依赖或运行脚本可能执行项目代码,请确认来源后再操作。

1. 选择版本管理方式

在“软件管理”的开发工具中,可以管理 Homebrew 来源的 Node.js;“Mac 工具”中的 nvm 管理器支持安装、环境检测、版本检查、更新和卸载。需要多个 Node.js 版本共存时,可使用 nvm 安装项目所需版本。

Devio 按安装来源展示版本和操作入口。不要把 Homebrew、nvm 和官方安装包当作同一种安装来源:更新方式不同,项目也可能依赖某个具体版本。

2. 让项目使用正确的 Node.js

在“网站”中创建 Node.js 项目,选择项目目录、已安装的运行版本、npm 启动脚本和目标端口。项目已有 .nvmrc 时,Devio 支持匹配其中的版本要求;先确保相应版本已经安装。

默认运行环境优先使用系统安装,其次是 Homebrew、nvm。项目明确选择的版本保持独立。更新 nvm 版本时会保留旧版本和已有项目绑定,因此不要把“管理器更新”误认为“所有项目都已升级”。

3. 安装依赖,再选择构建或启动

在项目操作入口安装依赖,检查完整输出。根据项目需要执行构建,再选择 package.json 中实际存在的 npm 脚本启动。不同项目的脚本名称和参数可能不同,不能把 dev、start 或 build 当成每个项目都有的固定命令。

目标端口应与应用实际监听的端口一致。项目是否通过环境变量、命令行参数或配置文件接收端口,应按该项目的说明核对。

4. 分别检查项目端口与 Nginx

Node.js 项目启动与 Nginx 独立。项目自己的端口就绪后即可运行;通过站点域名访问前,需要在首页手动启动 Nginx。停止项目只结束该项目进程,不等于停止所有本地服务。

如果项目端口能访问、站点域名不能访问,检查 Nginx 是否启动以及域名解析。Devio 的网站访问诊断可以检查 hosts、DNS、系统代理和本机直连结果,帮助区分应用报错与访问路径问题。

常见问题

终端 node 版本与项目不一样:先查看项目已选择的版本。终端默认环境与项目绑定是不同的检查对象,不要仅凭一个终端输出判断项目版本。

找不到 npm 脚本:确认所选目录包含正确的 package.json,并查看其中的 scripts。子目录或多包仓库通常需要选择实际应用目录。

启动失败或端口冲突:先查看“项目日志”的第一条有效错误,再到“设置 → 系统设置”检测端口。不要把依赖安装失败、端口占用和域名不可达混为一类问题。

需要升级 Node.js:先停止受影响项目并检查兼容性。官方安装包升级可能替换本机旧版本及 npm、npx;Homebrew 与 nvm 来源应继续按各自方式管理。升级后重新验证依赖安装、构建与应用启动。

哪些工作仍由项目本身决定

Devio 提供运行版本和进程管理,不能替代项目自己的依赖约束、环境变量或构建配置。遇到框架特定报错时,应结合项目日志与框架文档处理。

查看首页常见问题,或返回博客。


发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注