maven 的安装使用
请关注 www.ppst.cc 在线视频教程平台
安装和运行Maven
11
2.3.1. 在Mac OSX上安装Maven
你可以从http://maven.apache.org/download.html下载Maven的二进制版本。下载最新
的，下载格式最方便你使用的版本。找个地方存放它，并把存档文件解开。如果你把存
档文件解压到 /usr/local/maven-2.0.9 ；你可能会需要创建一个符号链接，那样就能
更容易使用，当你升级Maven的时候也不再需要改变环境变量。
/usr/local % ln -s maven-2.0.9 maven
/usr/local % export M2_HOME=/usr/local/maven
/usr/local % export PATH=/usr/local/maven/bin:/usr/local/bin:/usr/local/maven/bin:/usr/将Maven安装好后，你还需要做一些事情以确保它正确工作。你需要将它的 bin 目录
（该例中为 /usr/local/maven/bin）添加到你的命令行路径下。你还需要设置 M2_HOME
环境变量，其对应值为Maven的根目录（该例中为 /usr/local/maven）。
注意
在OSX Tiger和OSX Leopard上安装指令是相同的。有报告称Maven 2.0.6正
和XCode的预览版本一起发布。如果你安装了XCode，从命令行运行 mvn 检
查一下它是否可用。 XCode把Maven安装在了/usr/share/maven。我们强烈建
议安装最新版本的Maven 2.0.9，因为随着Maven 2.0.9的发布很多bug被修
正了，还有很多改进。
你还需要把 M2_HOME 和 PATH 写到一个脚本里，每次登陆的时候运行这个脚本。把下
面的几行加入到 .bash_login。
export M2_HOME=/usr/local/maven
export PATH=/usr/local/maven/bin:/usr/local/bin:/usr/local/maven/bin:/usr/kerberos/sbin:/一旦你把这几行加入到你的环境中，你就可以在命令行运行Maven了。
注意
这些安装指令假设你正运行bash。
2.3.2. 在Microsoft Windows上安装Maven
在Windows上安装Maven和在Mac OSX上安装Maven十分类似，最主要的区别在于安装位
置和设置环境变量。在这里假设Maven安装目录是 c:\Program Files\maven-2.0.9 ，但
是，只要你设置的正确的环境变量，把Maven安装到其它目录也一样。当你把Maven解
压到安装目录后，你需要设置两个环境变量——PATH和M2_M2_HOME。设置这两个环境变
量，键入下面的命令：
C:\Users\tobrien > set M2_HOME=c:\Program Files\maven-2.0.9
C:\Users\tobrien > set PATH=%PATH%;%M2_HOME%\bin
安装和运行Maven
12
在命令行设置环境变量后，你可以在当前会话使用Maven，但是，除非你通过控制面
板把它们加入系统变量，你将需要每次登陆系统的时候运行这两行命令。你应该在
Microsoft Windows中通过控制面板修改这两个变量。
2.3.3. 在Linux上安装Maven
遵循第 2.3.1 节 “在Mac OSX上安装Maven”的步骤，在Linux机器上安装Maven。
2.3.4. 在FreeBSD或OpenBSD上安装Maven
遵循第 2.3.1 节 “在Mac OSX上安装Maven”的步骤，在FreeBSD或者OpenBSD机器上安
装Maven。T
2.4. 验证Maven安装
当Maven安装完成后，你可以检查一下它是否真得装好了，通过在命令行运行 mvn -v。
如果Maven装好了，你应该能看到类似于下面的输出。
$ mvn -v
Maven 2.0.9
如果你看到了这样的输出，那么Maven已经成功安装了。如果你看不到，而且你的操作
系统找不到 mvn 命令，那么确认一下PATH和M2_HOME环境变量是否已经正确设置了。
2.5. Maven安装细节
Maven的下载文件只有大概1.5 MiB，它能达到如此苗条的大小是因为Maven的内核被设
计成根据需要从远程仓库获取插件和依赖。当你开始使用Maven，它会开始下载插件到
本地仓库中，就像第 2.5.1 节 “用户相关配置和仓库”所描述的那样。对此你可能比
较好奇，让我们先很快的看一下Maven的安装目录是什么样子。
/usr/local/maven $ ls -p1
LICENSE.txt
NOTICE.txt
README.txt
bin/
boot/
conf/
lib/
LICENSE.txt 包含了Apache Maven的软件许可证。第 2.8 节 “关于Apache软件
许可证”会详细描述该许可证。NOTICE.txt 包含了一些Maven依赖的类库所需要
的通告及权限。README.txt包含了一些安装指令。 bin/目录包含了运行Maven的
mvn脚本。 boot/ 目录包含了一个负责创建Maven运行所需要的类装载器的JAR文件
安装和运行Maven
13
(classwords-1.1.jar)。 conf/ 目录包含了一个全局的settings.xml文件，该文件用
来自定义你机器上Maven的一些行为。如果你需要自定义Maven，更通常的做法是覆写
~/.m2目录下的settings.xml文件，每个用户都有对应的这个目录。lib/ 目录有了一个
包含Maven核心的JAR文件(maven-2.0.9-uber.jar)。
2.5.1. 用户相关配置和仓库
当你不再仅仅满足于使用Maven，还想扩展它的时候，你会注意到Maven创建了一些本地
的用户相关的文件，还有在你home目录的本地仓库。在~/.m2目录下有：
~/.m2/settings.xml
该文件包含了用户相关的认证，仓库和其它信息的配置，用来自定义Maven的行
为。
~/.m2/repository/
该目录是你本地的仓库。当你从远程Maven仓库下载依赖的时候，Maven在你本地
仓库存储了这个依赖的一个副本。
注意
在Unix(和OSX)上，可以用 ~ 符号来表示你的home目录，（如~/bin表示/
home/tobrien/bin）。在Windows上，我们仍然使用 ~ 来表示你的home
目录。在Windows XP上，你的home目录是 C:\Documents and Settings
\tobrien，在Windows Vista上，你的home目录是 C:\Users\tobrien。从现
在开始，你应该能够理解这种路径表示，并翻译成你操作系统上的对应路
径。
2.5.2. 升级Maven
如果你遵循第 2.3.1 节 “在Mac OSX上安装Maven”和第 2.3.3 节 “在Linux上安装
Maven”，在Mac OSX或者Unix机器上安装了Maven。那么把Maven升级成较新的版本是
很容易的事情。只要在当前版本Maven（/usr/local/maven-2.0.9）旁边安装新版本的
Maven（/usr/local/maven-2.future），然后将符号链接 /usr/local/maven 从 /usr/
local/maven-2.0.9 改成 /usr/local/maven-2.future即可。你已经将M2_HOME环境变量
指向了 /usr/local/maven，因此你不需要更改任何环境变量。
如果你在Windows上安装了Maven，将Maven解压到 c:\Program Files\maven-2.future，
然后更新你的M2_HOME环境变量。
2.6. 获得Maven帮助
虽然本书的目的是作为一本全面的参考手册，但是仍然会有一些主题我们会不小心遗
漏，一些特殊情况和技巧我们也覆盖不到。Maven的核心十分简单，它所做的工作其实
安装和运行Maven
14
都交给插件了。插件太多了，以至于不可能在一本书上全部覆盖。你将会碰到一些本书
没有涉及的问题，碰到这种情况，我们建议你在下面的地址去寻找答案。
http://maven.apache.org
你首先应该看看这里，Maven的web站点包含了丰富的信息及文档。每个插件都有
几页的文档，这里还有一系列“快速开始”的文档，它们是本书内容的十分有帮
助的补充。虽然Maven站点包含了大量信息，它同时也可能让你迷惑沮丧。那里
提供了一个自定义的Google搜索框，以用来搜索已有的Maven站点信息，它能比
通用的Google搜索提供更好的结果。
Maven User Mailing List
Maven用户邮件列表是用户问问题的地方。在你问问题之前，你可以先搜索一下
之前的讨论，有可能找到相关问题。问一个已经问过的问题，而不先查一下该问
题是否存在了，这种形式不太好。有很多有用的邮件列表归档浏览器，我们发现
Nabble最有用。你可以在这里浏览邮件列表：http://www.nabble.com/Maven---
Users-f178.html。你也可以按照这里的指令来加入用户邮件列表：http://
maven.apache.org/mail-lists.html。
http://www.sonatype.com
Sonatype维护了一个本书的在线副本，以及其它Maven相关的指南。
注意
除去一些专门的Maven贡献者所做的十分优秀的工作，Maven web站点组织
的比较糟糕，有很多不完整的，甚至有时候有些误导人的文档片段。在整
个Maven社区里，插件文档的一般标准十分缺乏，一些插件的文档十分的丰
富，但是另外一些连基本的使用命令都没有。通常你最好是在用户邮件列表
里面去搜索下解决方案。
2.安装nexus 仓库
这些东西在 www.ppst.cc 网站都有视频，请有需要的可以去收看，上面还可以发布自己的视频，原创视频还可以通过收看收费来获取收益哦
安装和运行Maven
11
2.3.1. 在Mac OSX上安装Maven
你可以从http://maven.apache.org/download.html下载Maven的二进制版本。下载最新
的，下载格式最方便你使用的版本。找个地方存放它，并把存档文件解开。如果你把存
档文件解压到 /usr/local/maven-2.0.9 ；你可能会需要创建一个符号链接，那样就能
更容易使用，当你升级Maven的时候也不再需要改变环境变量。
/usr/local % ln -s maven-2.0.9 maven
/usr/local % export M2_HOME=/usr/local/maven
/usr/local % export PATH=/usr/local/maven/bin:/usr/local/bin:/usr/local/maven/bin:/usr/将Maven安装好后，你还需要做一些事情以确保它正确工作。你需要将它的 bin 目录
（该例中为 /usr/local/maven/bin）添加到你的命令行路径下。你还需要设置 M2_HOME
环境变量，其对应值为Maven的根目录（该例中为 /usr/local/maven）。
注意
在OSX Tiger和OSX Leopard上安装指令是相同的。有报告称Maven 2.0.6正
和XCode的预览版本一起发布。如果你安装了XCode，从命令行运行 mvn 检
查一下它是否可用。 XCode把Maven安装在了/usr/share/maven。我们强烈建
议安装最新版本的Maven 2.0.9，因为随着Maven 2.0.9的发布很多bug被修
正了，还有很多改进。
你还需要把 M2_HOME 和 PATH 写到一个脚本里，每次登陆的时候运行这个脚本。把下
面的几行加入到 .bash_login。
export M2_HOME=/usr/local/maven
export PATH=/usr/local/maven/bin:/usr/local/bin:/usr/local/maven/bin:/usr/kerberos/sbin:/一旦你把这几行加入到你的环境中，你就可以在命令行运行Maven了。
注意
这些安装指令假设你正运行bash。
2.3.2. 在Microsoft Windows上安装Maven
在Windows上安装Maven和在Mac OSX上安装Maven十分类似，最主要的区别在于安装位
置和设置环境变量。在这里假设Maven安装目录是 c:\Program Files\maven-2.0.9 ，但
是，只要你设置的正确的环境变量，把Maven安装到其它目录也一样。当你把Maven解
压到安装目录后，你需要设置两个环境变量——PATH和M2_M2_HOME。设置这两个环境变
量，键入下面的命令：
C:\Users\tobrien > set M2_HOME=c:\Program Files\maven-2.0.9
C:\Users\tobrien > set PATH=%PATH%;%M2_HOME%\bin
安装和运行Maven
12
在命令行设置环境变量后，你可以在当前会话使用Maven，但是，除非你通过控制面
板把它们加入系统变量，你将需要每次登陆系统的时候运行这两行命令。你应该在
Microsoft Windows中通过控制面板修改这两个变量。
2.3.3. 在Linux上安装Maven
遵循第 2.3.1 节 “在Mac OSX上安装Maven”的步骤，在Linux机器上安装Maven。
2.3.4. 在FreeBSD或OpenBSD上安装Maven
遵循第 2.3.1 节 “在Mac OSX上安装Maven”的步骤，在FreeBSD或者OpenBSD机器上安
装Maven。T
2.4. 验证Maven安装
当Maven安装完成后，你可以检查一下它是否真得装好了，通过在命令行运行 mvn -v。
如果Maven装好了，你应该能看到类似于下面的输出。
$ mvn -v
Maven 2.0.9
如果你看到了这样的输出，那么Maven已经成功安装了。如果你看不到，而且你的操作
系统找不到 mvn 命令，那么确认一下PATH和M2_HOME环境变量是否已经正确设置了。
2.5. Maven安装细节
Maven的下载文件只有大概1.5 MiB，它能达到如此苗条的大小是因为Maven的内核被设
计成根据需要从远程仓库获取插件和依赖。当你开始使用Maven，它会开始下载插件到
本地仓库中，就像第 2.5.1 节 “用户相关配置和仓库”所描述的那样。对此你可能比
较好奇，让我们先很快的看一下Maven的安装目录是什么样子。
/usr/local/maven $ ls -p1
LICENSE.txt
NOTICE.txt
README.txt
bin/
boot/
conf/
lib/
LICENSE.txt 包含了Apache Maven的软件许可证。第 2.8 节 “关于Apache软件
许可证”会详细描述该许可证。NOTICE.txt 包含了一些Maven依赖的类库所需要
的通告及权限。README.txt包含了一些安装指令。 bin/目录包含了运行Maven的
mvn脚本。 boot/ 目录包含了一个负责创建Maven运行所需要的类装载器的JAR文件
安装和运行Maven
13
(classwords-1.1.jar)。 conf/ 目录包含了一个全局的settings.xml文件，该文件用
来自定义你机器上Maven的一些行为。如果你需要自定义Maven，更通常的做法是覆写
~/.m2目录下的settings.xml文件，每个用户都有对应的这个目录。lib/ 目录有了一个
包含Maven核心的JAR文件(maven-2.0.9-uber.jar)。
2.5.1. 用户相关配置和仓库
当你不再仅仅满足于使用Maven，还想扩展它的时候，你会注意到Maven创建了一些本地
的用户相关的文件，还有在你home目录的本地仓库。在~/.m2目录下有：
~/.m2/settings.xml
该文件包含了用户相关的认证，仓库和其它信息的配置，用来自定义Maven的行
为。
~/.m2/repository/
该目录是你本地的仓库。当你从远程Maven仓库下载依赖的时候，Maven在你本地
仓库存储了这个依赖的一个副本。
注意
在Unix(和OSX)上，可以用 ~ 符号来表示你的home目录，（如~/bin表示/
home/tobrien/bin）。在Windows上，我们仍然使用 ~ 来表示你的home
目录。在Windows XP上，你的home目录是 C:\Documents and Settings
\tobrien，在Windows Vista上，你的home目录是 C:\Users\tobrien。从现
在开始，你应该能够理解这种路径表示，并翻译成你操作系统上的对应路
径。
2.5.2. 升级Maven
如果你遵循第 2.3.1 节 “在Mac OSX上安装Maven”和第 2.3.3 节 “在Linux上安装
Maven”，在Mac OSX或者Unix机器上安装了Maven。那么把Maven升级成较新的版本是
很容易的事情。只要在当前版本Maven（/usr/local/maven-2.0.9）旁边安装新版本的
Maven（/usr/local/maven-2.future），然后将符号链接 /usr/local/maven 从 /usr/
local/maven-2.0.9 改成 /usr/local/maven-2.future即可。你已经将M2_HOME环境变量
指向了 /usr/local/maven，因此你不需要更改任何环境变量。
如果你在Windows上安装了Maven，将Maven解压到 c:\Program Files\maven-2.future，
然后更新你的M2_HOME环境变量。
2.6. 获得Maven帮助
虽然本书的目的是作为一本全面的参考手册，但是仍然会有一些主题我们会不小心遗
漏，一些特殊情况和技巧我们也覆盖不到。Maven的核心十分简单，它所做的工作其实
安装和运行Maven
14
都交给插件了。插件太多了，以至于不可能在一本书上全部覆盖。你将会碰到一些本书
没有涉及的问题，碰到这种情况，我们建议你在下面的地址去寻找答案。
http://maven.apache.org
你首先应该看看这里，Maven的web站点包含了丰富的信息及文档。每个插件都有
几页的文档，这里还有一系列“快速开始”的文档，它们是本书内容的十分有帮
助的补充。虽然Maven站点包含了大量信息，它同时也可能让你迷惑沮丧。那里
提供了一个自定义的Google搜索框，以用来搜索已有的Maven站点信息，它能比
通用的Google搜索提供更好的结果。
Maven User Mailing List
Maven用户邮件列表是用户问问题的地方。在你问问题之前，你可以先搜索一下
之前的讨论，有可能找到相关问题。问一个已经问过的问题，而不先查一下该问
题是否存在了，这种形式不太好。有很多有用的邮件列表归档浏览器，我们发现
Nabble最有用。你可以在这里浏览邮件列表：http://www.nabble.com/Maven---
Users-f178.html。你也可以按照这里的指令来加入用户邮件列表：http://
maven.apache.org/mail-lists.html。
http://www.sonatype.com
Sonatype维护了一个本书的在线副本，以及其它Maven相关的指南。
注意
除去一些专门的Maven贡献者所做的十分优秀的工作，Maven web站点组织
的比较糟糕，有很多不完整的，甚至有时候有些误导人的文档片段。在整
个Maven社区里，插件文档的一般标准十分缺乏，一些插件的文档十分的丰
富，但是另外一些连基本的使用命令都没有。通常你最好是在用户邮件列表
里面去搜索下解决方案。
2.安装nexus 仓库
这些东西在 www.ppst.cc 网站都有视频，请有需要的可以去收看，上面还可以发布自己的视频，原创视频还可以通过收看收费来获取收益哦