环境准备：安装Node.js、Git、以及Magma CLI工具，配置开发环境

说实话，每次开始一个新项目，我最怕的就是环境配置。明明代码写好了，结果环境搭了两天还没跑起来——这种经历，我相信你也有过。

这一章，咱们就把Magma铸造模拟的“地基”打牢。我把自己踩过的坑、试过的捷径，都揉进这里。你跟着走一遍，基本不会出问题。

1. 安装Node.js：选对版本，省一半心

Node.js是咱们整个开发环境的核心。Magma CLI依赖它运行，后面的智能合约编译、测试也离不开它。

版本选择

我个人习惯用LTS（长期支持）版本。为什么？稳定。我在项目中遇到过好几次，用了最新版Node.js，结果某个依赖包不兼容，折腾半天才回退版本。所以，别追新，求稳。

推荐版本：Node.js 18.x LTS 或 20.x LTS

下载地址：https://nodejs.org

安装步骤

  1. 打开官网，下载对应你操作系统的安装包（Windows选.msi，macOS选.pkg）
  2. 双击安装，一路默认选项即可
  3. 安装完成后，打开终端（CMD或Terminal），验证一下：
node -v
npm -v

如果看到版本号，比如 v18.17.0 和 9.6.7，那就成了。

小技巧：我习惯用nvm（Node Version Manager）管理多个Node版本。这样不同项目可以切换不同的Node版本，互不干扰。尤其是你同时做几个区块链项目时，这招特别管用。

2. 安装Git：版本控制，保命神器

Git的重要性，不用我多说。你写代码，改配置，万一哪一步错了，git diff一看就知道改了啥。我曾经有一次，不小心删了整个项目文件夹，还好有Git历史记录，一键恢复——嗯，从那以后我再也不敢不提交了。

安装Git

  1. 去 https://git-scm.com 下载对应系统的安装包
  2. 安装时，建议勾选“Git Bash Here”和“Git GUI Here”，方便右键操作
  3. 其他选项保持默认，一路Next
  4. 验证安装：
git --version

输出类似 git version 2.40.0 就对了。

基础配置

装完Git，先配一下用户名和邮箱。不然你提交代码时，别人不知道是谁干的。

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

注意：邮箱最好和你用的代码托管平台（比如GitHub）一致，这样提交记录能关联到你的账号。

3. 安装Magma CLI：核心工具，一步到位

Magma CLI是咱们铸造模拟的“瑞士军刀”。它封装了铸造流程的各个环节，你只需要几条命令，就能完成从配置到模拟的全过程。

安装命令

确保Node.js和npm装好了，然后打开终端，执行：

npm install -g @magma-cli/core

这里有个坑——-g 表示全局安装。如果你遇到权限错误（比如macOS/Linux系统），前面加个 sudo：

sudo npm install -g @magma-cli/core

验证安装

magma --version

如果看到版本号，比如 1.2.3，恭喜你，环境基本就绪了。

避坑指南：我曾经在Windows上安装时，遇到“npm ERR! code ENOENT”错误。后来发现是npm缓存问题。解决办法很简单：先清缓存 npm cache clean --force，再重新安装。

4. 配置开发环境：让工具们协同工作

工具装好了，还得让它们“认识”彼此。说白了，就是配置环境变量和项目初始化。

检查环境变量

确保Node.js和Git的路径已经加到系统的PATH里。一般安装时会自动添加，但如果你发现终端里输入 node 或 git 提示“命令未找到”，那就得手动加一下。

  • Windows： 系统属性 → 高级 → 环境变量 → 在Path里添加Node.js和Git的安装路径
  • macOS/Linux： 编辑 ~/.bashrc 或 ~/.zshrc，添加 export PATH=$PATH:/usr/local/bin

初始化Magma项目

找个你喜欢的目录，创建项目文件夹：

mkdir magma-demo
cd magma-demo
magma init

magma init 命令会自动生成项目骨架，包括配置文件、合约模板、测试目录等。你想想看，要是手动搭这些，得花多少时间？

初始化完成后，目录结构大概是这样：

magma-demo/
├── contracts/        # 智能合约存放目录
├── config/           # 配置文件
├── scripts/          # 部署和测试脚本
├── test/             # 测试用例
├── magma.json        # Magma项目配置文件
└── package.json      # npm依赖管理

核心逻辑图：下面这张图展示了咱们整个环境配置的流程和关系。你看一遍，心里就有谱了。

Magma 开发环境配置流程 Node.js + npm Git 版本控制 Magma CLI 环境变量配置 magma init 项目初始化 运行时依赖 核心工具 生成项目骨架，准备开发

5. 验证环境：跑个Hello World

环境配好了，不跑个例子验证一下，心里不踏实。咱们用Magma CLI创建一个最简单的铸造模拟：

magma create-template hello-magma
cd hello-magma
magma build

如果看到 Build successful 的提示，说明整个环境已经打通了。你可以放心地往下走了。

我的经验：第一次跑 magma build 时，可能会下载一些依赖包，稍微等一会儿。如果网络慢，可以设置npm镜像源：npm config set registry https://registry.npmmirror.com，速度会快很多。

6. 常见问题与解决

问题 原因 解决办法
npm install 报权限错误 macOS/Linux 系统权限限制 加 sudo 或使用 nvm 管理
magma 命令找不到 全局安装路径未加入 PATH 检查环境变量，或重新安装
git 提交时提示身份信息缺失 未配置 user.name 和 user.email 执行 git config --global 配置
magma init 卡住不动 网络问题或 npm 缓存问题 切换镜像源，或清缓存重试

嗯，到这里，环境准备就全部完成了。你手头应该已经有了一个可以跑起来的Magma开发环境。接下来，咱们就可以真正开始铸造模拟的实战了。

专注资料整理

← 上一章 📖 返回目录 下一章 →