文章摘要

本文目标：本文翻译和实践Solidity语言编辑器REMIX官网帮助文档，但并不拘泥于逐字翻译，而时根据实践用中文语言讲透编辑器相关功能。

前置条件：了解以太坊ETH和Solidity语言。

技术收获：

• 使用REMIX编辑器进行Solidity语言编程，编译，运行，调试。

• REMIX界面介绍

  2 使用REMIX编辑器执行”HELLO WORLD”的智能合约

REMIX是一个智能合约编程语言Solidity的集成开发环境。

最简单的入门就是进行”HELLO WORLD”的程序运行。

2.1 智能合约编译

在CHROME浏览器上点击链接REMIX官网浏览器版编辑器（http://remix.ethereum.org/）即可打开REMIX编辑器。部分不能正常访问官网的，可以访问笔者的国内REMIX编辑器（http://remix2.ju3ban.net/）。

新增一个命名为“HelloWorld.sol”的文件，复制以下代码：

pragma solidity ^0.4.17;contract Hello         {    address creator;         string greeting;         function Hello(string _greeting) public       {        creator = msg.sender;        greeting = _greeting;    }        function greet() public constant returns (string)               {return greeting;    }        function setGreeting(string _newgreeting) public    {        greeting = _newgreeting;    }         /**********     Standard kill() function to recover funds      **********/        function kill() public    {         if (msg.sender == creator)            suicide(creator);  // kills this contract and sends remaining funds back to creator    }}

点击”Start to compile”按钮，会得到一下结果：

智能合约编译

除一些函数的告警提示外，结果表明该智能合约编译成功。

2.1.1 编译告警

如果编写的程序有告警，REMIX会有提示。一般来说，提示不必修改。

REMIXD编译告警

2.1.2 编译错误

为了说明编译错误案例，把该文件的第17行”return greeting;”改为”return _greeting;”, 重新编译，得到以下结果

REMIXD编译错误

如果编写的Solidity程序存在语法错误，Remix编译器会以粉红色底色提示显示错误原因，并在编辑器窗口提示位置。

编译错误演示完后，恢复第17行代码为”return greeting;”

2.1.3 详情信息

点击”Detail”按钮，可以看到详细信息。其中WEB3DEPLOY部分的内容就是在案例《第二课 如何实现以太坊最简智能合约“Hello World”的运行》(https://www.jianshu.com/p/2a5d60744988）中geth控制台使用的编译后代码。

DETAIL的内容

2.2 智能合约运行

2.2.1 创建智能合约

选择“Run”的页面，选择Environment环境为Javascript VM,在“Create”按钮前输入框内输入”Hello World!”[注意：输入字符串一定要有英文双引号]，点击“Create”按钮。

创建智能合约

2.2.2 运行greet函数

点击浅蓝色函数”greet”按钮，可以看到输出结果为“Hello World!”

运行函数greet

说明：浅蓝色按钮函数表示该交易函数运行时不需要消耗GAS的。

2.2.3 运行setGreeting函数

在setGreeting函数按钮的输入框输入内容”Hello Duncan!”, 运行后在点击执行”greet”函数，发现该函数的输出内容已变为”Hello Duncan!”了，说明setGreeting执行正常。

运行函数SetGreeting

说明：粉红色按钮函数表示该交易函数运行时是需要消耗GAS的。

3

REMIX界面详解

第2章以“Hello World”为例，介绍了REMIX集成环境的基本使用方法。本章介绍REMIX编辑器的详细功能描述。

3.1 REMIX集成环境概述

REMIX是一个智能合约编程语言Solidity的集成开发环境，它集成了一个调试器和测试环境。

如果你对以下内容感兴趣，REMIX是一个不错的学习方式：

• 开发智能合约（REMIX集成了SOLIDITY编辑器）

• 调试智能合约

• 获取已运行合约的状态和属性

• 调试已经提交的合约

• 分析SOLIDITY代码，以便减少编码错误和加强最佳实践

• 配合Mist(或者任何植入web3的工具)，REMIX可用于测试和调试DAPP分布式程序。（参考链接Debugging a Dapp using Remix - Mist - Geth ）（https://remix.readthedocs.io/en/latest/tutorial_mist.html）

详解介绍使用的程序案例为”ballot.sol”文件的代码，完整代码如下：

pragma solidity ^0.4.0;contract Ballot {    struct Voter {        uint weight;        bool voted;        uint8 vote;        address delegate;    }    struct Proposal {        uint voteCount;    }    address chairperson;    mapping(address => Voter) voters;    Proposal[] proposals;    /// Create a new ballot with $(_numProposals) different proposals.    function Ballot(uint8 _numProposals) public {        chairperson = msg.sender;       voters[chairperson].weight = 1;        proposals.length = _numProposals;    }    /// Give $(toVoter) the right to vote on this ballot.   /// May only be called by $(chairperson).    function giveRightToVote(address toVoter) public {        if (msg.sender != chairperson || voters[toVoter].voted) return;        voters[toVoter].weight = 1;    }    /// Delegate your vote to the voter $(to).    function delegate(address to) public {        Voter storage sender = voters[msg.sender]; // assigns reference        if (sender.voted) return;        while (voters[to].delegate != address(0) && voters[to].delegate != msg.sender)            to = voters[to].delegate;        if (to == msg.sender) return;        sender.voted = true;        sender.delegate = to;        Voter storage delegateTo = voters[to];        if (delegateTo.voted)            proposals[delegateTo.vote].voteCount += sender.weight;        else            delegateTo.weight += sender.weight;    }    /// Give a single vote to proposal $(toProposal).    function vote(uint8 toProposal) public {        Voter storage sender = voters[msg.sender];       if (sender.voted || toProposal >= proposals.length) return;        sender.voted = true;        sender.vote = toProposal;        proposals[toProposal].voteCount += sender.weight;    }    function winningProposal() public constant returns (uint8 _winningProposal) {        uint256 winningVoteCount = 0;       for (uint8 prop = 0; prop < proposals.length; prop++)            if (proposals[prop].voteCount > winningVoteCount) {                winningVoteCount = proposals[prop].voteCount;                _winningProposal = prop;           }    }}

REMIX主界面截图如下，具体说明参考各个子章节。

REMIX主界面截图

3.2 文件浏览器

文件浏览器

1）增加新文件(Create new File)

点击在浏览器上增加一个新的智能合约文件

增加新文件

2）打开文件(Add Local File)

打开存在文件

3） 匿名发布到GitHub（Publish to Gist）

匿名发布到GitHub

4） 复制文件列表到其他浏览器(Copy to another instance)

例如，把“http://remix2.ju3ban.net”的文件列表复制到另一个浏览器“http://remix.ju3ban.net”

修改输入目标浏览器的网址：

复制到别的浏览器

打开新的浏览器，文件列表已复制过来了：

别的浏览器的文件列表

5）链接本地服务器（Connect to Localhost）

在Remix文件浏览器上的文件并不会同步到本地文件系统，对浏览器文件列表的新增/修改/删除并不会同步本地文件。一般操作时，调试成功的代码需要在本地文件系统新建文件保存。Remix浏览器提供了一种方法，就是使用Remixd，允许保存和同步浏览器文件到你的本地计算机中。因为根据官网文档，笔者没有能够在Windows 10系统或者Ubuntu中安装成功Remixd，本文不再详细介绍该功能。有兴趣的朋友欢迎根据官网文档（）尝试使用REMIXD同步。成功者欢迎跟辉哥反馈交流，补充完整这个文档。

链接本地文件系统

3.3 Solidity语言编辑器

Solidity 浏览器

Solidity语言编辑器重要的功能列表：

• TAB页面显示打开的文件

• 编译告警或者错误会显示在编辑器最左侧边

• Remix自动保存当前文件（修改后5秒内）

• +/- 表示增加/减少编辑器的字体大小

3.4 终端输出器

终端输出器窗口

终端输出器功能说明：

• 点击1按钮可隐藏终端输出器

• 点击2按钮可情况输出器内容

• 点击3按钮可复制地址信息等到缓存，便于粘贴

• 点击Details按钮可展开交易详细内容

• 点击Debug按钮可调试该交易合约

• 点击复选框，可增加选择显示所有的交易还是只显示智能合约相关的交易程序。默认只显示后者。

终端显示内容

• 输入关键字可搜索定位输出内容 
  例如输入”Hello “关键字，相关的内容就显示出来了。

搜索Hello关键字

• 监听网络（Listen to network） 
  勾选后，REMIX不仅监听REMIX编辑器中创建的交易，还监听当前环境中所有的交易。

3.5 分页控制面板

3.5.1 编译合约

Compile控制面板

发布到Swarm网络(Publish on Swarm)

点击“Publish on Swarm”按钮可把智能合约源码和对应的ABI信息发布到网络上。这个合约智能是非抽象类的才能发布。

合约发布后，你可以点击Detail按钮，在弹出窗口的“SWARM LOCATION”

位置找到对应的MetaDATA信息。

信息中的SWARM LOCATION位置有对应网址，在能科学上网的计算机就可找到该合同的MetaData信息 “bzzr://165fad4c3d8ead3a7fe28296777b4bedafb09bb57de2e9ba39c1547866437182”

3.5.2 运行

Run控制面板

重点特性说明

1） 环境选择

JavaScript VM: 所有交易在浏览器的沙盒中被执行。这以为着没有结果是永久保存的。当页面重载后，一个新的区块链会被从零开始运行，老的会被丢弃。

Injected Provider: Remix将连接被植入的Web3对象。例如Mist或者Metamask钱包是提供植入的Web3对象的例子。例如《第八课 如何调试以太坊官网的智能合约众筹案例》（https://www.jianshu.com/p/c7c87c7ad74f）就是使用Meta的账号。

Web3 Provider: Remix将连接到一个远程节点。你可以用这个地址来选择钱包客户端：geth, parity or any Ethereum client.

2） 初始化合约

创建合约

“Create”按钮用于创建合约。合约创建时，需要参考左边构建函数定义（智能合约的同名函数为构建函数）的类型来输入参数。

创建合约

注意：如果输入参数为地址或者字符串，都需要使用英文双引号(“”)囊括起来，使用英文(“,”)表示输入参数分割。

运行合约

假设给出的地址是一个选择合同的实例。通过这种方法就可以跟已经运行的合同进行交互。要特别谨慎使用该功能，因为系统不做验证。运行时要确认信任这个地址的合同。

等待(pending)合约

挂起合约

等待合约表示还没有完成执行过程的合约。按钮功能描述参考上述附件。

3.5.1.1 Web3 Provider远程节点配置

1） 启动Ganache客户端。不熟悉的，可参考该篇文章的对应关键字“在WINDOWS上安装Ganache”安装好客户端（https://www.jianshu.com/p/683ea7d62a39）。

启动Ganache客户端

2） 输入Web3 Provider远程节点，例如Ganache的签宝地址为“HTTP://127.0.0.1:7545”

输入WEB3 privider的服务器地址

3） 输入完成后，Remix的账号列表更新为Ganache的账号列表了。

3.5.3 调试

调试/回滚和单步调试是一个很重要的功能，点击《第九课 如何在Remix环境下进行Solidity代码单步调试》（https://www.jianshu.com/p/a2502274b092）文章查看。

3.5.4 设置

重要特性说明：

• Solidity version：编译SOLIDITY版本，不调整的话系统会默认选择最新正式发布的版本。

• Always use Ethereum VM at Load：勾选此项会在重新加载时默认选择JavaScript VM环境。

• Enable Optimization：勾选此项会节省运行GAS，JVM等测试环境可不用勾选。

3.5.5 分析

分析面板显示的是最后一次编译的信息，默认情况下每一次编译都会产生一个新的分析。

这个分析面板显示的是合约代码的详细信息，它可以帮助你避免代码错误或者增强编码能力。

Security: 
Transaction origin: 如果tx.origin被使用则会告警； 
Check effects: 避免潜在的可重入性BUG； 
Inline assembly:  使用植入汇编方式； 
Block timestamp: Semantics maybe unclear； 
Low level calls: Semantics maybe unclear； 
Block.blockhash usage: 自毁调用；

Gas & Economy: 
Gas costs: 函数的GAS消耗太高会告警。 
This on local calls: 勾选后本地函数会被唤醒；

Miscellaneous: 
Constant functions: 检查潜在的常量函数 
Similar variable names: 检查变量名是否太相似

Miscelllaneous下方显示的是本次编译的优化告警，供程序员优化代码使用。

3.5.6 支持

支持页面，可点击需求技术支持和交流。

4

典型错误介绍

4.1 REMIX编译器官网链接打不开

提示内容：点击官网链接（http://remix.ethereum.org），如果打不开或者有错误提示“mock compiler: source not found”

原因分析： 这个主要是不能科学上网引起官网浏览器不能下载完全。

解决办法：

1，参考欧阳哥哥的文章《【以太坊开发】Remix IDE本地部署与配置个性风格》完成本地REMIX的部署； 
2，采用一个已国内部署的REMIX浏览器链接：http://remix2.ju3ban.net

4.2 参数转换失败

提示内容： 终端输出器显示为“transact to Donation.moveFund errored: Error encoding arguments: Error: Assertion failed ”

原因分析： 
Solidity函数定义为”function moveFund(address _to, uint _amount)”

RUN面板的函数输入参数如下，希望转移5个ETH给目标账号。

“0x14723a09acff6d2a60dcdf7aa4aff308fddc160c”,500000000000000

结果提示错误。

这个原因主要是因为”5 ＊10^18”的值超过了计算器的范围，需要增加”“来让程序进行转换。Solidity的默认单位为wei，1 ETH = 1*10^18 wei。

解决办法： 
输入参数改为2个参数均有双引号则不会有错误提示。

“0x14723a09acff6d2a60dcdf7aa4aff308fddc160c”,”500000000000000”

在remix中，任何输入参数都可以带”“表示。

5

参考文档

REMIX英文官网帮助文档（http://remix.readthedocs.io/en/latest/）

【以太坊开发】Remix IDE本地部署与配置个性风格（https://www.jianshu.com/p/afdee36ccbc0）

SOLIDITY语言官网中文版（http://solidity-cn.readthedocs.io/zh/develop/solidity-in-depth.html）