> For the complete documentation index, see [llms.txt](https://u.naturaldao.io/solidity/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://u.naturaldao.io/solidity/1.6-solidity-yu-yan-jiao-cheng/package.md).
# 1.6.1 典型Solidity源文件包含的组成部分
Solidity是以太坊创始人之一的Gavin Wood博士发明的以太坊智能合约编程语言，它是一个面向合约的高级语言，其语法类似Javascript，运行在以太坊虚拟机中。
Solidity是静态类型的编程语言，编译期间会检查其数据类型，它支持继承，类和复杂的用户定义类型。
本节我们将会分门别类介绍Solidity语言的各个特性。本章所有内容基于Solidity 0.4.24版本，其参考网址为： 。
## 1.6.1 典型Solidity源文件包含的组成部分
一个Solidity源文件可以包含任意的智能合约定义，标识符及编译标识。
### 1.6.1.1 Pragma版本
Solidity源文件可以包含标识符所指定的编译器版本。如果不指定编译器版本，系统可能调用不兼容的编译器来编译源文件，从而产生编译错误。
编译器标识符的使用方式如下：
pragma solidity ^0.4.0;
经过这样定义，系统编译该文件时，就不会调用早于0.4.0和晚于（包括）0.5.0的编译器编译。也可以使用npm定义更复杂的编译选项。
### 1.6.1.2 导入源文件
#### 1.6.1.2.1 语义及语法
和javascript类似，Solidity可以导入其它源文件。
可以在全局作用域导入其它源文件，比如：
import “filename”；
该语句将在此源文件中包含进”filename”的全部内容。
import \* as symbolName from "filename";
上面这条语句创建了新的标识“symbolName”，这个新的标识文件名将包含“filename”的所有内容。
import {symbol1 as alias, symbol2} from "filename";
上面这条语句将把“filename”中的“symbol1”标识为“alias”，“symbol2”标识为“symbol2”。
还有一种用法，可能会更符合多数程序员的习惯：
import "filename" as symbolName;
它等价于 import \* as symbolName from "filename";
#### 1.6.1.2.2 路径
在上述定义中“filename”总是被定义为以“/”为分隔符的路径名。“.”表示当前目录，“..”表示当前目录的上一层目录。所有的“filename”定义都会被视为绝对路劲，除非定义以“.”或“..”开头。
#### 1.6.1.2.3 重映射在编译器中的用法
当调用编译器时，不仅可以定义如何找到路径中的第一个目录在哪里，还可以重新映射路径。比如：
github.com/ethereum/dapp-bin/library
可以被重新映射为：
/usr/local/dapp-bin/library
这样编译器就会从“/usr/local/dapp-bin/library”读取文件。如果定义了多个重映射，则包含最长字符的那个会被首先作为重映射。这种用法可用于“回退重映射”（“fallback-remapping”），比如：
“”
可被重新映射为：
“/usr/local/include/solidity”
重映射依赖于源代码的上下文。当同一个库文件有不同的版本时，用户可以利用这个特性定义具体使用哪个版本。我们以Solc和Remix这两个编译器为例看具体的使用方法。
1）solc编译器
Solc是个命令行编译器。在solc中，重映射可作为context:prefix = target的参数。如果所有的重映射参数是文件名，则这些文件都会被编译。这种机制完全后向兼容。
如果用户把github.com/ethereum/dapp-bin/ 克隆到本地/usr/local/dapp-bin，可以使用下列定义：
import "github.com/ethereum/dapp-bin/library/iterable\_mapping.sol" as it\_mapping;
然后用下列命令进行编译：
solc github.com/ethereum/dapp-bin/=/usr/local/dapp-bin/ source.sol
下面我们看一个更复杂的例子。加入用户要使用的一个模块，这个模块会用到一个很老版本的dapp-in。这个dapp-in的路径为/usr/local/dapp-bin\_old，可以用如下命令：
solc module1:github.com/ethereum/dapp-bin/=/usr/local/dapp-bin/ \\
module2:github.com/ethereum/dapp-bin/=/usr/local/dapp-bin\_old/ \\
source.sol
这样module2里面使用的就是老版本的dapp-bin\_old，而module1里使用的就是新版本的dapp-in。
2）Remix编译器
Remix能自动把github重映射，自动从github读取文件，用户可以导入迭代映射，如下所示：
import "github.com/ethereum/dapp-bin/library/iterable\_mapping.sol" as it\_mapping;
### 1.6.1.3 注释
Solidity支持单行注释“//”和多行注释“/\*…\*/”。
// 这是单行注释
/\*
这是
多行注释
\*/
另外，还有一种注释符，称为“natspec”注释，这种注释方式并没有正式地出现在官方文档中。这种方式用三个斜杠表示“///”或“/\*\*…\*/”。这种注释方式必须紧跟在函数声明或定义之前。用户可以在注释内描述函数的功能，注释函数的判断条件等。在下例中，我们注释了合约名，两个输入参数和两个返回值。
pragma solidity ^0.4.0;
/\*\* @title Shape calculator. \*/
contract shapeCalculator {
/\*\* @dev Calculates a rectangle's surface and perimeter.
\* @param w Width of the rectangle.
\* @param h Height of the rectangle.
\* @return s The calculated surface.
\* @return p The calculated perimeter.
\*/
function rectangle(uint w, uint h) returns (uint s, uint p) {
s = w \* h;
p = 2 \* (w + h);
}
}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://u.naturaldao.io/solidity/1.6-solidity-yu-yan-jiao-cheng/package.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.