Solidity语言编辑器REMIX指导大全

￡神魔★判官ぃ 2022-05-19 11:57 278阅读 0赞

# 1. 文章摘要 #

**【本文目标】**  
本文翻译和实践Solidity语言编辑器REMIX官网帮助文档，但并不拘泥于逐字翻译，而时根据实践用中文语言讲透编辑器相关功能。  
**【前置条件】**  
了解以太坊ETH和Solidity语言。  
**【技术收获】**  
1). 使用REMIX编辑器进行Solidity语言编程，编译，运行，调试。  
2). REMIX界面介绍

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

REMIX是一个智能合约编程语言Solidity的集成开发环境。  
最简单的入门就是进行"HELLO WORLD"的程序运行。

## 2.1 智能合约编译 ##

在CHROME浏览器上点击链接[REMIX官网浏览器版编辑器][REMIX]即可打开REMIX编辑器。部分不能正常访问官网的，可以访问笔者的[国内REMIX编辑器][REMIX 1]。  
新增一个命名为“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"按钮，会得到一下结果：

![700][]

0.智能合约编译.png

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

### 2.1.1 编译告警 ###

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

![700 1][]

REMIXD编译告警

### 2.1.2 编译错误 ###

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

![700 2][]

REMIXD编译错误

如果编写的Solidity程序存在语法错误，Remix编译器会以粉红色底色提示显示错误原因，并在编辑器窗口提示位置。  
编译错误演示完后，恢复第17行代码为"return greeting;"

### 2.1.3 详情信息 ###

点击"Detail"按钮，可以看到详细信息。其中WEB3DEPLOY部分的内容就是在案例[《第二课 如何实现以太坊最简智能合约“Hello World”的运行》][_Hello World]中geth控制台使用的编译后代码。

![700 3][]

DETAIL的内容

## 2.2 智能合约运行 ##

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

![700 4][]

创建智能合约

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

![700 5][]

运行函数greet

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

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

![700 6][]

运行函数SetGreeting

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

# 3. REMIX界面详解 #

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

## 3.1 REMIX集成环境概述 ##

REMIX是一个智能合约编程语言Solidity的集成开发环境，它集成了一个调试器和测试环境。  
如果你对以下内容感兴趣，REMIX是一个不错的学习方式：  
1，开发智能合约（REMIX集成了SOLIDITY编辑器）  
2，调试智能合约  
3，获取已运行合约的状态和属性  
4，调试已经提交的合约  
5，分析SOLIDITY代码，以便减少编码错误和加强最佳实践  
6，配合Mist(或者任何植入web3的工具)，REMIX可用于测试和调试DAPP分布式程序。（参考链接[Debugging a Dapp using Remix - Mist - Geth ][Debugging a Dapp using Remix - Mist - Geth]）  
详解介绍使用的程序案例为"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主界面截图如下，具体说明参考各个子章节。

![700 7][]

REMIX主界面截图

**具体界面介绍章节分类如下：**  
3.2 [文件浏览器][Link 1]  
3.3 [Solidity语言编辑器][Solidity]  
3.4 [终端输出器][Link 2]  
3.5 分页控制面板  
3.5.1 [编译合同][Link 3]  
3.5.2 [运行][Link 4]  
3.5.3 [调试][Link 5]  
3.5.4 [设置][Link 6]  
3.5.5 [分析][Link 7]  
3.5.6 [支持][Link 8]

## 3.2 文件浏览器 ##

![564][]

文件浏览器

**1）增加新文件(Create new File)**  
点击在浏览器上增加一个新的智能合约文件

![700 8][]

9.增加新文件.png

**2）打开文件(Add Local File)**

![700 9][]

打开存在文件

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

![700 10][]

11. 匿名发布到GitHub.png

**4） 复制文件列表到其他浏览器(Copy to another instance)**  
例如，把“[http://remix2.ju3ban.net][REMIX 1]”的文件列表复制到另一个浏览器“[http://remix.ju3ban.net][http_remix.ju3ban.net]”  
修改输入目标浏览器的网址：

![700 11][]

12.复制到别的浏览器.png

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

![700 12][]

13.别的浏览器的文件列表.png

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

![700 13][]

14. 链接本地文件系统.png

## 3.3 [Solidity语言编辑器][Solidity] ##

![700 14][]

15. Solidity 浏览器.png

Solidity语言编辑器重要的功能列表：  
1，TAB页面显示打开的文件  
2，编译告警或者错误会显示在编辑器最左侧边  
3，Remix自动保存当前文件（修改后5秒内）  
4，+/- 表示增加/减少编辑器的字体大小

## 3.4 [终端输出器][Link 2] ##

![700 15][]

终端输出器窗口

**终端输出器功能说明：**  
1，点击1按钮可隐藏终端输出器  
2，点击2按钮可情况输出器内容  
3，点击3按钮可复制地址信息等到缓存，便于粘贴  
4，点击Details按钮可展开交易详细内容  
5， 点击Debug按钮可调试该交易合约  
6， 点击复选框，可增加选择显示所有的交易还是只显示智能合约相关的交易程序。默认只显示后者。

![338][]

17. 终端显示内容.png

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

![700 16][]

18. 搜索Hello关键字

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

## 3.5 分页控制面板 ##

### 3.5.1 [编译合约][Link 3] ###

![700 17][]

20. Compile控制面板.png

1，发布到Swarm网络(Publish on Swarm)  
点击“Publish on Swarm”按钮可把智能合约源码和对应的ABI信息发布到网络上。这个合约智能是非抽象类的才能发布。  
合约发布后，你可以点击Detail按钮，在弹出窗口的“SWARM LOCATION”  
位置找到对应的MetaDATA信息。  
信息中的SWARM LOCATION位置有对应网址，在能科学上网的计算机就可找到该合同的MetaData信息 “bzzr://165fad4c3d8ead3a7fe28296777b4bedafb09bb57de2e9ba39c1547866437182”

### 3.5.2 [运行][Link 4] ###

![700 18][]

21. Run控制面板.png

**重点特性说明**  
**1） 环境选择**  
**JavaScript VM**: 所有交易在浏览器的沙盒中被执行。这以为着没有结果是永久保存的。当页面重载后，一个新的区块链会被从零开始运行，老的会被丢弃。  
**Injected Provider**: Remix将连接被植入的Web3对象。例如Mist或者Metamask钱包是提供植入的Web3对象的例子。例如[《第八课 如何调试以太坊官网的智能合约众筹案例》][Link 10]就是使用Meta的账号。  
**Web3 Provider**: Remix将连接到一个远程节点。你可以用这个地址来选择钱包客户端：geth, parity or any Ethereum client.

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

![700 19][]

25. 创建合约.png

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

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

**3\] 等待(pending)合约**

![663][]

26，挂起合约.png

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

3.5.1.1 Web3 Provider远程节点配置

1） 启动Ganache客户端。不熟悉的，可参考该篇文章的对应关键字[“在WINDOWS上安装Ganache”][WINDOWS_Ganache]安装好客户端。

![700 20][]

22. 启动Ganache客户端.png

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

![700 21][]

23. 输入WEB3 privider的服务器地址.png

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

![482][]

24. 账号为Ganache的账号列表.png

### 3.5.3 [调试][Link 5] ###

调试/回滚和单步调试是一个很重要的功能，点击[《第九课 如何在Remix环境下进行Solidity代码单步调试》][_Remix_Solidity]文章查看。

### 3.5.4 [设置][Link 6] ###

![700 22][]

27. Settiongs.png

**重要特性说明：**  
（1）Solidity version：编译SOLIDITY版本，不调整的话系统会默认选择最新正式发布的版本。  
（2）Always use Ethereum VM at Load：勾选此项会在重新加载时默认选择JavaScript VM环境。  
（3）Enable Optimization：勾选此项会节省运行GAS，JVM等测试环境可不用勾选。

### 3.5.5 [分析][Link 7] ###

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

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

![700 23][]

28. Analysis页面.png

**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下方显示的是本次编译的优化告警，供程序员优化代码使用。

![381][]

28. Analysis页面2.png

### 3.5.6 [支持][Link 8] ###

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

![700 24][]

remix\_supporttab

# 4.典型错误介绍 #

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

**提示内容：**点击官网链接（[http://remix.ethereum.org][REMIX]），如果打不开或者有错误提示“mock compiler: source not found”  
**原因分析：** 这个主要是不能科学上网引起官网浏览器不能下载完全。  
**解决办法：**  
1，参考欧阳哥哥的文章[《【以太坊开发】Remix IDE本地部署与配置个性风格》][Remix IDE]完成本地REMIX的部署；  
2，采用一个已国内部署的REMIX浏览器链接：[http://remix2.ju3ban.net][REMIX 1]

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.参考文档 #

1)，[REMIX英文官网帮助文档][REMIX 2]  
2), [【以太坊开发】Remix IDE本地部署与配置个性风格][Remix IDE]  
3), [SOLIDITY语言官网中文版][SOLIDITY]

[REMIX]: http://remix.ethereum.org/
[REMIX 1]: http://remix2.ju3ban.net/
[700]: /images/20220519/f16a877cabe64a89806a2116eb0ad769.png
[700 1]: /images/20220519/6775a237b05c4dcfb2a2dbdce0df6cc4.png
[700 2]: /images/20220519/edea21c42d9c425282cd185df51fd488.png
[_Hello World]: https://www.jianshu.com/p/2a5d60744988
[700 3]: /images/20220519/f56ab55a3cef4734aebe6e84d0404794.png
[700 4]: /images/20220519/4ec48b419316467c97aa99c16c9d7e6c.png
[700 5]: /images/20220519/02b80d94d976448799374d333bf84eed.png
[700 6]: /images/20220519/a25900b05fa2466bbdd7e0a5bc7c5d3b.png
[Debugging a Dapp using Remix - Mist - Geth]: https://remix.readthedocs.io/en/latest/tutorial_mist.html
[700 7]: /images/20220519/aa308fb667c24bad83be2b4a9a2fe987.png
[Link 1]: http://remix.readthedocs.io/en/latest/file_explorer.html
[Solidity]: http://remix.readthedocs.io/en/latest/solidity_editor.html
[Link 2]: http://remix.readthedocs.io/en/latest/terminal.html
[Link 3]: http://remix.readthedocs.io/en/latest/compile_tab.html
[Link 4]: http://remix.readthedocs.io/en/latest/run_tab.html
[Link 5]: http://remix.readthedocs.io/en/latest/debugger_tab.html
[Link 6]: http://remix.readthedocs.io/en/latest/settings_tab.html
[Link 7]: http://remix.readthedocs.io/en/latest/analysis_tab.html
[Link 8]: http://remix.readthedocs.io/en/latest/support_tab.html
[564]: /images/20220519/399f8281f532424a97870c05d4750fd5.png
[700 8]: /images/20220519/f6909408192c46bf90aa6c74e40a867a.png
[700 9]: /images/20220519/44a0e9a4d4e044be9a4b283818ac00a4.png
[700 10]: /images/20220519/4f4fc69f9ce648f1af7a974084655d82.png
[http_remix.ju3ban.net]: http://remix.ju3ban.net/
[700 11]: /images/20220519/051e560c4eeb47f9ab2686bc9fc6e7ca.png
[700 12]: /images/20220519/3df5fff71a4b4f96b98922de5bc879d2.png
[Link 9]: http://remix.readthedocs.io/en/latest/tutorial_remixd_filesystem.html
[700 13]: /images/20220519/fea23af67c9f44ddb01f74d1426c6c3d.png
[700 14]: /images/20220519/bbe4ffae21ff49cd8300427b68577e9d.png
[700 15]: /images/20220519/ca45e3991dbc4a0db61b092475f20c6b.png
[338]: /images/20220519/59d2b86c0e7e41b68973d598ca461ece.png
[700 16]: /images/20220519/9226b8e628f84dfba9efe3b1b8cfb46b.png
[700 17]: /images/20220519/32755856813f447a8df18281ba64b638.png
[700 18]: /images/20220519/1fdf0eb4618c426788f5095485932751.png
[Link 10]: https://www.jianshu.com/p/c7c87c7ad74f
[700 19]: /images/20220519/60ca11bae81c4158bc2e765ec434bbb0.png
[663]: /images/20220519/7ba4e59ace1d4e1cb7a96597596e8d04.png
[WINDOWS_Ganache]: https://www.jianshu.com/p/683ea7d62a39
[700 20]: /images/20220519/810c2ba193284fe79858142563978a40.png
[700 21]: /images/20220519/90db4bc69348480d8dc0c912589bca11.png
[482]: /images/20220519/76348af1f72d4b8f89741bf877924777.png
[_Remix_Solidity]: https://www.jianshu.com/p/a2502274b092
[700 22]: /images/20220519/4bc4eaa245354f02b4bff7b2ac6b3ea3.png
[700 23]: /images/20220519/69269c3b966d4d9ab777cd72d1be6797.png
[381]: /images/20220519/4d6b1bd7fa3c4e5f9c8a42124c2f41f0.png
[700 24]: /images/20220519/a13f2c09c62c43d391f22fea9586e83b.png
[Remix IDE]: https://www.jianshu.com/p/afdee36ccbc0
[REMIX 2]: http://remix.readthedocs.io/en/latest/
[SOLIDITY]: http://solidity-cn.readthedocs.io/zh/develop/solidity-in-depth.html