Meteor 是一个全栈 JavaScript 框架,适用于构建实时 Web 应用程序。
本文将介绍两种不同的方式来搭建 Meteor 的开发环境:通过全局安装 Meteor 工具、使用 Docker 镜像,以及创建和运行一个简单的 Meteor 项目。因为之前一直漏了这部分,但官方的教程又是英文,所以出一篇文来简单介绍下如果搭建开发环境,如果有任何问题或者安装过程出现任何报错等欢迎留言,我用了三年多还是见识过不少奇怪问题的啦~
1. 全局安装 Meteor 工具
1.1 检查 Node.js 版本
在安装 Meteor 之前,建议先安装或更新 Node.js。Meteor 会自动安装 Node.js 作为依赖,但它的兼容版本会随不同版本的 Meteor 而变化。安装最新版的 Node.js 可以确保你在未来使用最新版本的 Meteor 时不会遇到兼容性问题。
需要20.14+
确认 Node.js 和 npm 已安装:
node -v
npm -v
如果是windows,直接去Nodejs官网下载,
1.2 安装 Meteor
1.2.1 使用npx直接运行
npx meteor
1.2.2 安装工具
使用以下命令来全局安装 Meteor:
curl https://install.meteor.com/ | sh
这个脚本会自动下载最新版本的 Meteor,并将其安装在系统的全局路径中。
1.3 验证安装
安装完成后,可以通过以下命令验证是否成功安装:
meteor --version
若显示 Meteor 的版本号,则说明安装成功。
2. 使用 Docker 镜像
如果你更喜欢使用 Docker 进行开发,或者需要在隔离的环境中运行 Meteor 应用,可以通过官方提供的 Docker 镜像来搭建开发环境。这样做的好处是你不需要直接在系统上安装任何工具,而且可以轻松管理和删除环境。
2.1 安装 Docker
参考 Docker安装指南安装,windows可下载Ui版本的docker desktop
安装完成后,确保 Docker 已启动并正在运行:
docker ps
2.2 拉取官方 Docker 镜像
Meteor 官方提供了一个预配置的 Docker 镜像。你可以使用以下命令从 Docker Hub 拉取它:
docker pull geoffreybooth/meteor-base
确保是用的这个镜像哦!不要用错了
2.3 运行 Docker 容器 - 使用docker-compose
你可以在一个新的容器中运行 Meteor 应用。假设你要创建并运行一个新的项目,执行以下命令:
docker run -it -v $(pwd):/app -w /app geoffreybooth/meteor-base create my-app
这个命令将在当前目录中创建一个名为 my-app
的 Meteor 项目。接下来,你可以创建一个docker-compose.yml文件:
version: '3'
services:
app:
image: geoffreybooth/meteor-base
ports:
- '80:3000'
depends_on:
- mongo
environment:
ROOT_URL: ${
APP_ROOT_URL:-http://localhost}
MONGO_URL: mongodb://mongo:27017/meteor
PORT: 3000
mongo:
image: mongo:latest
command:
- --storageEngine=wiredTiger
volumes:
- data:/data/db
volumes:
data:
然后运行:
docker compose up
上面的命令会启动项目并映射主机的 3000 端口到容器中的 3000 端口。现在,你可以在浏览器中访问 http://localhost:3000
来查看项目。
3. 创建一个新的 Meteor 项目
无论是通过全局安装的 Meteor 工具还是 Docker 镜像,你都可以按照以下步骤创建一个新的项目。
3.1 创建项目
使用以下命令创建一个新的项目:
meteor create my-app
这个命令会在当前目录中创建一个名为 my-app
的目录,并初始化一个简单的 Meteor 项目结构。
3.2 项目结构
新创建的项目具有以下基础结构:
my-app/
├── .meteor/ # Meteor 配置文件夹
├── client/ # 存放客户端代码
├── server/ # 存放服务器端代码
├── public/ # 存放公开资源(图片、字体等)
└── imports/ # 可选:模块化导入
你可以将 JavaScript 或 TypeScript 文件分别放入 client/
和 server/
目录中,Meteor 会自动处理这些文件。
4. 运行和调试 Meteor 项目
4.1 启动项目
进入项目目录后,运行以下命令来启动应用程序:
cd my-app
meteor run
默认情况下,应用会在 localhost:3000
端口运行。你可以打开浏览器并访问 http://localhost:3000
来查看应用的运行情况。
4.2 调试项目
Meteor 内置了调试支持。你可以在启动项目时加上 --inspect
参数以启用 Node.js 的调试模式:
meteor --inspect
这样,你可以通过 Chrome 开发工具或 VS Code 等工具进行远程调试。你可以在代码中插入 debugger;
语句,或直接使用断点调试。
此外,Meteor 还支持热重载,这意味着在你修改客户端代码时,应用会自动刷新,无需手动重启。
总结
通过本文的步骤,你可以选择以下三种方式来搭建 Meteor 开发环境:
- 全局安装 Meteor 工具:这是最简单的方式,适合本地开发和长期使用。
- 使用 Docker 镜像:适合需要隔离环境的开发者,也适合在 CI/CD 环境中部署。
- 创建和运行项目:无论你使用哪种安装方式,创建项目和运行调试的过程都是相似的。
如果还有问题,可以参考官方的英文教程Meteor指南,本文额外介绍了一下与docker的使用(因为meteor更新还是比较快的,多个版本安装升级的时候,会有不少包残余等,清理比较麻烦,但用docker相对就比较简单-旧版本不需要就把镜像删除清理一下即可,不影响主系统)
另外,可以在做阿里云ECS/服务器实验的时候,在一个虚拟环境中安装测试哦~