版本; T6 X6 t* w& X0 t0 r  ~1 M8 N
Solidity的版本遵循 语义化版本原则，作为发布版本的补充， 每日开发构建 （nightly development builds）也是可用的。这个每日开发构建不保证能正常工作，尽管尽了最大的努力，但仍可能包含未记录的和／或重大的改动。我们推荐使用最新的发布版本。下面的包安装程序将使用最新发布版本。
1 U  L1 A0 M) A/ [Remix+ Z% a1 Q; T/ E2 ~! O8 t
我们推荐使用 Remix 来开发简单合约和快速学习 Solidity。* ~$ e8 z* I! T& d, n3 u2 e
Remix 可在线使用，而无需安装任何东西。如果你想离线使用，可按 https://github.com/ethereum/browser-solidity/tree/gh-pages 的页面说明下载 zip 文件来使用。 该页面有进一步详细说明如何安装 Solidity 命令行编译器到你计算机上。如果你刚好要处理大型合约，或者需要更多的编译选项，那么你应该选择使用命令行编译器 solc。' m/ Y1 t# `* _- N% a
npm / Node.js
- O# g# R3 q; }! ]使用 npm 可以便捷地安装Solidity编译器solcjs。但该 solcjs 程序的功能相对于本页下面的所有其他选项都要少。在 使用命令行编译器 一章中，我们假定你使用的是完整功能的编译器。 所以，如果你是从 npm 安装 solcjs ，就此打住，直接跳到 solc-js 去了解。( `4 ~# ^5 x/ c( d; |9 ]7 v
注意: solc-js 项目是利用 Emscripten 从 C++ 版的 solc 跨平台编译为 JavaScript 的，因此，可在 JavaScript 项目中使用 solcjs（如同 Remix）。 具体介绍请参考 solc-js 代码库。  i7 z2 U* @0 f! c
npm install -g solc& O- c/ ?' q+ Y+ h* {* F9 Q, n4 N
在命令行中，使用 solcjs 而非 solc 。 solcjs 的命令行选项同 solc 和一些工具（如 geth )是不兼容的，因此不要期望 solcjs 能像 solc 一样工作。4 N) T* `5 P' f) l9 A" O6 Q" \
Docker
/ B/ V  E! X. l. a' @' L我们为编译器提供了最新的docker构建。 stable 仓库里的是已发布的版本，nightly 仓库则是在开发分支中的带有不稳定变更的版本。5 @: a+ I/ z5 z6 t" ~* Q/ k& s( |
docker run ethereum/solc:stable solc --version6 A( X: w5 ~5 A6 k3 [
目前，docker 镜像只含有 solc 的可执行程序，因此你需要额外的工作去把源代码和输出目录连接起来。
+ g1 d' U& h9 G  j二进制包
5 M* ]1 U7 Q1 P7 `; K% n可在 solidity/releases 下载 Solidity 的二进制安装包。1 ?2 o3 a( [! E# x8 y
对于 Ubuntu ，我们也提供 PPAs 。通过以下命令，可获取最新的稳定版本：  d1 `, U7 g" ^9 I, k) h
sudo add-apt-repository ppa:ethereum/ethereum1 m, S1 p  a3 M" P% R
sudo apt-get update- ^5 n3 a& N5 u5 C
sudo apt-get install solc
( E% e8 U7 f, W! w$ A3 ]8 j/ \) p; B当然，你也可安装尝鲜的开发者版本：
  X8 {* Y5 c6 C# Y$ `6 G% {9 O1 msudo add-apt-repository ppa:ethereum/ethereum# ~% L+ o, W2 t. u+ N$ k. p
sudo add-apt-repository ppa:ethereum/ethereum-dev3 N7 ^2 S7 t8 q
sudo apt-get update
% K1 }/ \4 \& l; F% n' ~0 Hsudo apt-get install solc: \$ h/ y5 `/ M
同时，也提供可安装 所有支持的Linux版本 下的 snap package 。通过以下命令，可获取最新的稳定版本：- p% w8 v) ^" V. L1 k
sudo snap install solc
8 Z% _; m1 J9 L! G4 L或者，如果你想测试 develop 分支下的最新变更，可通过如下方式安装开发者版本：9 D0 p+ D3 m& J6 U- T
sudo snap install solc --edge
: H3 ]; c, {9 W" {7 }' _0 X同样，Arch Linux 也有提供安装包，但仅限于最新的开发者版本：
5 G) s' z& p1 U. a- E+ b/ Spacman -S solidity4 f1 S2 t* G2 Q: w, R, t, D
在写本文时，Homebrew 上还没有提供预构建的二进制包（因为我们从 Jenkins 迁移到了 TravisCI ）。 我们将尽快提供 homebrew 下的二进制安装包，但至少从源码构建的方式还是行得通的：
3 H: [( ?, Y' Ybrew update( C# s. N( H0 [0 [
brew upgrade
' e( w: y$ R: y7 S; sbrew tap ethereum/ethereum% v  l: @* |! k: C3 P6 v3 }
brew install solidity3 U* X) C/ p- ^
如果你需要特定版本的 Solidity ，你需要从 Github 上安装一个 Homebrew formula。 你可查阅 solidity.rb commits on Github 的提交记录，去寻找包含solidity.rb文件改动的特殊提交。然后使用brew进行安装：0 d5 [% e& _+ ~" x" P7 _
brew unlink solidity
) d- i7 S9 d. q& Q; U: l# c# Install 0.4.8! Z4 V0 E2 V/ F8 D: T
brew install https://raw.githubusercontent.com/ethereum/homebrew-ethereum/77cce03da9f289e5a3ffe579840d3c5dc0a62717/solidity.rb5 k& E4 o0 r# Z6 _/ {) Q% V: p0 [
Gentoo Linux 下也提供了安装包，可使用 emerge 进行安装：
' Q; }9 B3 l/ O( f& ~4 }$ {( Cemerge dev-lang/solidity
( b! j3 S9 I8 x4 T" l从源代码编译4 p# V7 n( w2 o) i# [* l5 J  e2 r
克隆代码库9 C9 \' c7 ]# v7 X+ g* \; y  w+ R* \) \
执行以下命令，克隆源代码：
4 D( M. s& E8 Wgit clone --recursive https://github.com/ethereum/solidity.git
, [2 u( e  a8 E( C7 [cd solidity
. V& t( r8 g$ ?" [7 ]如果你想参与 Solidity 的开发, 你可分叉 Solidity 源码库后，用你个人的分叉库作为第二远程源：4 K4 O/ d0 r% Z: x- }) T
cd solidity
# f7 Z. ~8 n1 O( `git remote add personal git@github.com:[username]/solidity.git
0 P9 q; ?& [! J+ M, b( |3 PSolidity 有 Git 子模块，需确保完全加载它们：* O" c1 H* }6 H2 [2 y
git submodule update --init --recursive
- ?- b+ @# m8 b9 \6 ]先决条件 - macOS2 C: b2 b. w( `9 L- I
在 macOS 中，需确保有安装最新版的 Xcode， Xcode 包含 Clang C++ 编译器， 而 Xcode IDE 和其他苹果开发工具是 OS X 下编译 C++ 应用所必须的。 如果你是第一次安装 Xcode 或者刚好更新了 Xcode 新版本，则在使用命令行构建前，需同意 Xcode 的使用协议：5 H; Z  P$ F# F, u" Z
sudo xcodebuild -license accept# x- F1 O6 G: K
Solidity 在 OS X 下构建，必须 安装 Homebrew 包管理器来安装依赖。 如果你想从头开始，这里是 卸载 Homebrew 的方法。
9 t% u4 C- `6 d7 [( P先决条件 - Windows) c7 X* p# m. R" J7 H, Q" Y# X
在Windows下构建Solidity，需下载的依赖软件包：4 u2 j( @1 l; T* Y4 _
Git for Windows        C从Github上获取源码的命令行工具9 I! S6 f; e, Y) k# S7 a3 S
CMake        跨平台构建文件生成器2 {8 Q1 B; `* o4 k; `* y
Visual Studio 2017 Build Tools        C++ 编译器
8 h6 _% X# W6 o2 A: t! yVisual Studio 2017 (Optional)        C++ 编译器和开发环境
+ @0 }1 p% U( E5 k0 j) {5 J' v$ v如果你已经有了 IDE，仅需要编译器和相关的库，你可以安装 Visual Studio 2017 Build Tools。
( W9 p+ X$ M/ c8 M# ?) ?Visual Studio 2017 提供了 IDE 以及必要的编译器和库。所以如果你还没有一个 IDE 并且想要开发 Solidity，那么 Visual Studio 2017 将是一个可以使你获得所有工具的简单选择。
9 d- ]' s# I8 C4 j/ v. I# C- G4 A这里是一个在 Visual Studio 2017 Build Tools 或 Visual Studio 2017 中应该安装的组件列表：
; W+ b" o( q5 Y, i* Q7 ~Visual Studio C++ core featuresVC++ 2017 v141 toolset (x86,x64)Windows Universal CRT SDKWindows 8.1 SDKC++/CLI support
# I! G4 S; B% z0 W) D3 z3 C8 [# x! ]' w* N
外部依赖: u; ?; r  F+ C8 g* ^- ~$ {
在 macOS、Windows和其他 Linux 发行版上，有一个脚本可以“一键”安装所需的外部依赖库。本来是需要人工参与的多步操作，现在只需一行命令:% u2 F; J5 J# S# o7 `9 c
./scripts/install_deps.sh/ C; f% k3 u! e, J
Windows 下执行：
3 V" B$ }3 N' a- Pscripts\install_deps.bat4 ?( p8 R3 @, L+ l  `- x: H  G
命令行构建
8 f% e/ Q9 g! Y: m& `5 h确保你已安装外部依赖（见上面）
6 V+ v& K' b1 I" F/ H( XSolidity 使用 CMake 来配置构建。Linux、macOS 和其他 Unix系统上的构建方式都差不多：
' F# B+ Y, o: P: J2 _7 dmkdir build, J* C) S* w* U% S
cd build* k# Z& e3 ^2 R: ~; w. @' w
cmake .. && make' Y/ N) \1 y+ g( l% |2 Y
也有更简单的：) o! Z0 I7 n$ n/ ?; Z5 m
#note: 将安装 solc 和 soltest 到 usr/local/bin 目录8 |: ?+ `- n# p; A
./scripts/build.sh' d; y0 d# p7 @5 A0 e, C, {
对于 Windows 执行：3 Y# h* v, j2 Z6 q* U9 b/ b- `8 O/ ^; c
mkdir build% p) R7 N9 z! T: X- o/ W
cd build
& Z; J6 n# D& ~5 k& y' C/ fcmake -G "Visual Studio 15 2017 Win64" ..
* \" Z/ c- }8 P$ B) d这组指令的最后一句，会在 build 目录下创建一个 solidity.sln 文件，双击后，默认会使用 Visual Studio 打开。我们建议在VS上创建 RelWithDebugInfo 配置文件。
& s! e( a% v9 N6 K- d或者用命令创建：2 I$ `! r* n$ j; k/ W6 ?5 G2 n
cmake --build . --config RelWithDebInfo. Z# a( I! a" F, P) Z& D) |0 V
CMake参数
. Z/ Z1 E3 L1 A- b如果你对 CMake 命令选项有兴趣，可执行 cmake .. -LH 进行查看。
7 `1 R) K5 m4 C3 ~  m$ q+ e# I版本号字符串详解7 T, d8 J% q3 V6 h
Solidity 版本名包含四部分：& I1 d& h$ y" B& e& `
版本号预发布版本号，通常为 develop.YYYY.MM.DD 或者 nightly.YYYY.MM.DD以commit.GITHASH格式展示的提交号由若干条平台、编译器详细信息构成的平台标识
' p, S' K1 U1 o# Y如果本地有修改，则 commit 部分有后缀 .mod。
, _+ f3 V1 b( K
3 c" P- p6 Y9 F5 @5 g* F  Q2 @7 d' j这些部分按照 Semver 的要求来组合， Solidity 预发布版本号等价于 Semver 预发布版本号， Solidity 提交号和平台标识则组成 Semver 的构建元数据。
& F+ _5 y  }8 G; G; M6 M( b发行版样例：0.4.8+commit.60cc1668.Emscripten.clang.2 X+ f! [" i3 a% V2 K6 R; F
预发布版样例： 0.4.9-nightly.2017.1.17+commit.6ecb4aa3.Emscripten.clang
) r, O2 n, C# ~, g版本信息详情. F# ]% _9 ~5 Q# S
在版本发布之后，补丁版本号会增加，因为我们假定只有补丁级别的变更会在之后发生。当变更被合并后，版本应该根据semver和变更的剧烈程度进行调整。最后，发行版本总是与当前每日构建版本的版本号一致，但没有prerelease指示符。
* e4 \: D: x: v! O" K( ]; ~例如：
7 v0 w) D0 X) o3 M% @! D/ ~; b0.4.0 版本发布
5 F% k5 c* p! M3 V$ K1 ]8 F从现在开始，每晚构建为 0.4.1 版本  @1 I' a, g( i& t1 e7 T  I
引入非破坏性变更 —— 不改变版本号
  a4 N: P* u" S! E; b  J% n3 k% ~引入破坏性变更 —— 版本跳跃到 0.5.0
+ a% s6 ^  g0 i; X0.5.0 版本发布
9 h, `9 W/ p! l* x# }该方式与 version pragma 一起运行良好。