同一台 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 提供运行版本和进程管理,不能替代项目自己的依赖约束、环境变量或构建配置。遇到框架特定报错时,应结合项目日志与框架文档处理。
发表回复