前几篇咱们聊了 X Layer 的方方面面,从技术架构到钱包配置到跨链操作。今天这篇,咱们来一个 实战教程 : 如果你是一个普通开发者,想在 X Layer 上部署自己的第一个 DApp,具体应该怎么做?零基础也能跟上,手把手教你。

一、你需要准备什么?
部署一个最简单的 DApp,你只需要:
- ✅ 一台电脑(Windows/Mac/Linux 都行)
- ✅ 安装 Node.js(16+ 版本)
- ✅ 安装 MetaMask 浏览器插件
- ✅ X Layer 上有少量 OKB(用于支付部署 Gas 费)
- ✅ 一个代码编辑器(推荐 VS Code)
二、咱们来部署什么?
为了让教程实用又简单,咱们来部署一个「简单计数器 DApp」:
- 一个智能合约:存储一个计数器数值,提供增加和查询功能
- 一个前端页面:按钮点击增加计数器,页面实时显示数值
虽然简单,但涵盖了 DApp 开发的核心流程:写合约 → 编译 → 部署 → 前端交互。

三、步骤 1:创建项目
打开终端(Windows 用 PowerShell,Mac 用 Terminal),执行:
mkdir my-xlayer-dapp
cd my-xlayer-dapp
npm init -y
安装必要的依赖:
npm install –save-dev hardhat @nomicfoundation/hardhat-toolkit
四、步骤 2:初始化 Hardhat
执行 npx hardhat init,选择「Create a JavaScript project」。这会自动生成项目结构:
- contracts/ — 放智能合约
- scripts/ — 放部署脚本
- test/ — 放测试文件
- hardhat.config.js — 配置文件
五、步骤 3:编写智能合约
在 contracts/ 目录下创建 Counter.sol:
简单说明:合约有一个 count 变量(初始为 0),一个 increment()函数让计数 +1,一个 getCount()函数返回当前值。用 Solidity 0.8.20 版本。
六、步骤 4:配置 Hardhat 连接 X Layer
修改 hardhat.config.js,添加 X Layer 网络配置:URL 填 https://rpc.xlayer.tech,chainId 填 196。同时配置 Etherscan 验证(如果需要验证合约源码)。

七、步骤 5:编译合约
执行 npx hardhat compile。编译成功后会在 artifacts/ 目录生成 ABI 和字节码。
八、步骤 6:编写部署脚本
在 scripts/ 目录下创建 deploy.js。脚本逻辑很简单:获取部署账户、部署 Counter 合约、打印合约地址。账户私钥通过环境变量传入(不要硬编码!)。
九、步骤 7:部署到 X Layer
执行部署命令:npx hardhat run scripts/deploy.js –network xlayer
几秒钟后,终端会输出合约地址。这就是你的合约在 X Layer 上的「家」。
十、步骤 8:搭建前端页面
用简单的 HTML+JavaScript 即可。核心逻辑:
- 用 ethers.js 连接 MetaMask
- 切换到 X Layer 网络(chainId: 196)
- 用合约 ABI 和地址创建合约实例
- 调用 increment()和 getCount()函数
前端页面只需要一个按钮(「+1」)和一个显示区域(当前计数)。

十一、常见问题 FAQ
Q:部署失败,提示「insufficient funds」?
A:你的地址上 OKB 不够。通过 OKX 交易所提币到 X Layer 即可。
Q:前端连不上合约?
A:检查 MetaMask 是否切换到了 X Layer 网络,RPC URL 是否正确。
Q:Gas 费比预期高?
A:合约部署的 Gas 费比日常交互高,这是正常的。日常使用(调用函数)费用很低。
Q:需要验证合约源码吗?
A:建议验证,让其他用户能看到你的合约代码,增加信任度。可以用 hardhat-etherscan 插件验证。
十二、下一步学什么?
部署完第一个 DApp 后,你可以:
- 🚀 学习 ERC-20 代币标准,发一个自己的代币
- 🚀 学习 Uniswap V2 的 AMM 机制,做一个简单的 DEX
- 🚀 学习 NFT(ERC-721),做一个 NFT 铸造平台
- 🚀 学习 Chainlink 预言机,接入真实价格数据
总结
在 X Layer 上部署 DApp 的流程和在以太坊主网上 几乎完全一样,唯一的区别就是把 RPC URL 和 chainId 改成 X Layer 的。得益于 X Layer 的全 EVM 兼容性,你不需要学习新的编程语言或工具。
最关键的优势是 成本低:部署合约可能只要几毛钱 OKB,日常交互几乎免费。这让开发者可以大胆尝试、快速迭代,不用担心试错成本。
如果你是新手,建议从最简单的计数器 DApp 开始,然后逐步增加复杂度。编程就是一个「从简单到复杂」的过程。加油!💪
