目前最流行的版本控制软件：Git的基本使用 前排提示： 本篇博客篇幅较长，建议结合目录查看！ 目录： 写在前面 1、关于版本控制系统 定义 版本控制的必要性： 常见的版本控制系统 2、Git与Github 0x01.安装Git 0x02.Github中的一些基本概念 Repository Issue Star Fork Pull Request Watch Wiki Gist 0x03.添加SSH key 0x04.克隆仓库 0x05.初始化仓库 0x06.提交修改 0x07.分支操作 查看分支 建立新分支 切换分支 建立并切换到新分支 推送本地分支到远程仓库 合并分支 删除分支 重命名分支 0x08.标签操作 附注标签 轻量标签 切换标签 推送标签 删除标签 查看所有标签 给提交打标签 写在前面 1、关于版本控制系统 定义 版本控制（Version control）是维护项目的标准作法，能追踪项目从诞生一直到定案的过程。此外，版本控制也是一种软件工程技巧，借此能在软件开发的过程中，确保由不同人所编辑的同一程序文件都得到同步，记录项目内各个模块的改动历程，并为每次改动都编上序号。 一种简单的版本控制形式如下：工程的初代版本为“1.0”，当做了第一次改变后，版本等级改为“1.1”，以此类推。因此，版本控制能提供给开发者将项目恢复到之前任一状态的选择权，这种选择权在设计过程进入死胡同时特别重要。 版本控制的必要性： 常会利用版本控制来追踪维护源代码、文件以及配置文件等的改动，并且提供控制这些改动控制权的程序； 有时候，一个程序同时存有两个以上的版本，例如：在一个稳定版本中程序错误已经被修正、但没有加入新功能；在另一个开发版本则有新的功能正在开发、也有新的错误待解决，这使得同时间需要不同的版本； 此外，为了找出只存在于某一特定版本中（由于修正了某些问题、或新加功能所导致）的程序错误，或找出程序错误出现的版本，开发者也需要比对不同版本的代码以找出问题的位置。 常见的版本控制系统 集中式版本控制系统：由一台或多台主计算机组成中心服务器，所有业务单元和项目版本库都集中存储在这个中心服务器上，开发时，要先从中央服务器取得项目最新的版本，一次开发完毕之后，再将工作量推送给中央服务器。就像是一个图书馆，如果要改一本书的内容，则需要把书先从图书馆借出来，然后修改，改完之后再放回图书馆。 因此，集中式版本控制系统最的大缺点就是中央服务器出了问题，所有人都没法工作了。 常见的集中式版本控制系统有SVN、CVS等。 分布式版本控制系统：分布式版本系统没有绝对的中央服务器，每个人的电脑上都是一个完整的版本库，多个人进行协同工作时，只需将自己的修改与其他人的修改进行交换即可 和集中式版本控制系统相比，分布式版本控制系统的安全性要高很多，因为每个人电脑里都有完整的版本库，其中一个人的电脑坏了不要紧，从其他人那里复制一个就可以了。 Git就是常见的分布式版本控制系统之一，也是目前最流行的版本控制系统。 2、Git与Github 准确地说，Git与Github根本不是同一个概念。 Git是指由Linus（就是那位二十多年前徒手撸出Linux内核的大佬）编写的分布式版本控制系统，于2005年以GPL发布。最初目的是为了更好地管理Linux内核开发。 自2002年以来，Linus一直使用BitKeeper作为Linux内核主要的版本控制系统以维护代码。在Linux社区中，主张应该使用开放源代码的软件来作为Linux内核的版本控制系统。Linus曾考虑过采用现成软件作为版本控制系统（例如Monotone），但这些软件都存在一些问题，特别是性能不佳。 2005年，Linux社区中的安德鲁·垂鸠写了一个可以连接BitKeeper的存储库的简单程序，BitKeeper著作权拥有者拉里·麦沃伊便认为安德鲁·垂鸠对BitKeeper内部使用的协议进行了逆向工程，决定收回无偿使用BitKeeper的许可。Linux内核开发团队与BitMover公司进行磋商无果后，Linus决定自行开发版本控制系统以替代BitKeeper，在十天的时间编写出git第一个版本。于是，世界上最流行的版本控制系统就这么戏剧式地诞生了。 而GitHub是通过Git进行版本控制的软件源代码托管服务平台，由GitHub公司（曾称Logical Awesome）的开发者Chris Wanstrath、P. J. Hyett和Thomas Preston-Werner使用Ruby on Rails编写而成，于2007年10月1日开始开发。beta版本开始上线于2008年2月，4月份正式上线。这是他们的logo，名字叫Octocat： 截止到2020年1月，GitHub已经有超过4000万注册用户和1.9亿代码库（包括至少2800万开源代码库），事实上已经成为了世界上最大的代码存放网站和开源社区，国内很多人戏称为“全球最大同性交友网站”。 2018年6月4日晚，微软宣布以75亿美元的股票收购GitHub。 Github服务器在国外，处于半被墙的状态，有时正常访问，有时又打不开。与之类似的代码托管平台Gitee可以看做是国内版的Github，缺点是开源项目不如Github丰富，当然，由于在访问时速度更快，更适合国内用户托管代码。而且，部分开源项目是同时托管在这两个平台上的，所以碰到无法打开的Github项目时，在Gitee上找找也许会有惊喜。 0x01.安装Git Git在全平台均可使用。 Git官网：Git (git-scm.com) 官方中文文档：Git - Book (git-scm.com) Windows系统Git安装包下载链接：Git - Downloads Linux系统安装Git：Git - Download for Linux and Unix Mac系统安装Git：Git - Download for macOS 安装完成之后在控制台中输入git，如果出现如下输出说明安装成功： 前面提到过，Git只是一个分布式版本管理软件，每个人的计算机都是一份完整的版本库，对这份版本库进行修改之后，将每个人的修改进行合并。但是如果不在同一个内网中，合并修改就会变得困难。此时也需要一个中央服务器来辅助进行代码的合并。这也就是Github、Gitee、Gitlab等平台最基本的作用。 因此，我们还需要注册一个Github/Gitee账号，将我们的代码托管到平台上面（从某种角度上将它看成一个专门存放代码的云盘也未尝不可）。Github注册账号及用户界面介绍可以参考这篇文章：从0开始学习 GitHub 系列之「加入 GitHub」 (qq.com)，本篇博客不再介绍。 0x02.Github中的一些基本概念 Repository 仓库，即项目，要在GitHub上开源一个项目，那就必须要新建一个Repository。 Issue 问题的意思，举个例子，比如开源的项目，别人发现项目中有bug，或者哪些地方做的不够好，他就可以提个Issue，即问题，提的问题多了，也就是 Issues ，然后开发者看到了这些问题就可以去逐个修复，修复ok了就可以一个个的Close掉。 Star 就是给项目点赞，这个star的含金量还是挺高的。 Fork 这个可以翻译成分叉，你想在某个开源项目的基础上做些改进，然后应用到自己的项目中，这个时候就可以Fork这个项目，与此同时你的GitHub主页上就多了一个项目，只不过这个项目是基于这个开源项目（本质上是在原有项目的基础上新建了一个分支）。而你就可以随心所欲的去改进这个项目了，丝毫不会影响原有项目的代码与结构。 Pull Request 发起请求，这个其实是基于Fork的，还是上面那个例子，如果你在项目基础上做了改进，就可以把自己的改进合并到原有项目里，这个时候你就可以发起一个Pull Request（简称PR），原有项目开发者会收到这个请求，这个时候他会review代码，并且测试觉得OK了，就会接受PR，这个时候新的改进会被合并进原有项目。 Watch 可以理解为观察，如果Watch了某个项目，以后如果这个项目有更新，都会收到关于这个项目的通知提醒。 Wiki 一般来说，项目的主页有README文件基本就够了，但是有些时候项目的一些用法很复杂，就需要有详细的说明文档给使用者。这个时候就可以用Wiki，使用markdown语法即可进行编写。 Gist 如果没有项目可以开源，只是单纯的想分享一些代码片段，那这个时候Gist就派上用场了。 0x03.添加SSH key 当我们对代码进行提交时，Github/Gitee要怎么知道是我们提交的代码，而不是别人提交的呢，所以就需要进行授权来确认我们的身份。 Github和Gitee服务器可以选择使用SSH公钥或GPG公钥来进行授权，这里采用SSH授权方式，提交代码之前需要先添加SSH key配置。大概步骤就是先在本地生成SSH key，然后将本地生成的SSH key添加到Github或者Gitee上。 SSH（Secure Shell）是一种建立在应用层基础上的安全协议，一般用于远程登录会话和其他网络服务。由于在传输过程中对数据进行了加密和压缩，因此可以有效防止远程管理过程中的“中间人攻击”，传输速度也会更快，还能够防止”DNS欺骗“和”IP欺骗“等。 生成SSH密钥： ssh-keygen -t rsa 这句命令的意思是用RSA算法生成密钥（windows系统最好在Git Bash下执行，cmd终端可能并没有安装ssh），执行后出来三次提示均按回车，命令执行完会生成id_rsa（密钥）和id_rsa.pub（公钥）这两个文件。Linux/Mac系统在~/.ssh下，windows系统在C:\Users\用户名\.ssh（用户名是自己电脑的用户名）下，需要设置显示隐藏文件选项才能看到。 将id_rsa.pub用文本编辑器打开，复制里面的内容。 添加公钥到Github/Gitee： 进入Github/Gitee的设置界面，在左侧选项列表找到SSH keys选项 将刚才复制的公钥粘贴上去，公钥标题可写可不写，然后保存，这样就完成了公钥的添加。 0x04.克隆仓库 说来惭愧，这是我接触到Github之后很长时间内最常用的操作（因为就只会这一个操作）。命令很简单： git clone [仓库链接] 这个命令的作用就是从Github上下载别人仓库的项目文件，可能是从clone直接音译过来的原因，这个操作一般都称克隆，而不叫下载。 克隆操作只需要有远程仓库链接即可，不需要Github账户也可以进行。克隆完之后项目文件的位置就是执行命令时所处的文件夹。 远程仓库链接在项目主页就可以找到： 0x05.初始化仓库 所谓初始化本地仓库，个人理解就是向本地的项目根目录文件夹中加入一些Git配置文件，使其可以被Git识别以进行版本控制，因为项目文件夹是不能直接进行版本控制的。 初始化本地仓库命令很简单，进入本地项目文件夹（或者用空文件夹），在该目录下执行： git init 也可以在命令后面加入文件夹路径，将指定文件夹初始化成本地仓库： git init [项目文件夹名路径] 项目初始化成功会有Initialized empty Git repository in xxxxxxx的提示，原项目文件夹中多出一个.git隐藏文件夹。此时初始化的本地项目还没有关联到远程仓库。 当然，有本地仓库还不行，我们本意是要把本地仓库推送到远程仓库，因此，还需要在Github/Gitee上建一个远程仓库。点击网站右上角加号，找到“New Repository（新建仓库）” 上图最后三项是用来初始化远程仓库的，如果这三项都不选就创建了仓库，就会提示用命令行来手动初始化远程仓库（所以建议对命令行不感冒的同学直接使用自带的初始化操作）。 来记录一下用命令行手动初始化远程仓库的步骤： 先在本地初始化好的Git项目中新建一个README.md项目说明文件（也可以是别的文件名） 在项目目录下执行命令与远程仓库进行关联： git remote add origin [远程仓库链接] 依次执行以下命令向暂存区加入修改文件，并编辑提交信息 git add README.md # 引号中就是本次提交信息，可修改 git commit -m "first commit" 向远程仓库推送本地仓库文件： Gitee只执行这条命令即可推送： git push -u origin master 从2020年10月开始，Github的默认分支从master变成了main，因此还需要将本地默认主分支重命名为main才能推送成功： git branch -M main git push -u origin main 如果不重命名主分支，就会出现“error: src refspec main does not match any，error: failed to push some refs to ..”的错误。 上述命令执行完之后，再刷新远程仓库界面，就进入了初始化好的远程仓库： 对于都已经初始化过的本地空仓库与远程仓库，使其建立关联可以这样做： # 先关联远程仓库 git remote add origin [仓库远程链接] # 再将远程仓库内容拉取到本地 git pull origin master 0x06.提交修改 所谓修改，就是相对于上次提交之后项目发生的改变（项目文件的增、删、改）。 其中要涉及到push和pull这两个互为相反的概念： Push：直译就是“推”的意思，这个操作可以把本地代码推到远程仓库，这样本地仓库跟远程仓库就可以保持同步了。 Pull：直译为“拉”的意思，如果别人提交代码到远程仓库，这个时候本地仓库代码与远程仓库代码并不一致，所以需要把远程仓库的最新代码拉下来，以保证两端代码的同步。 同时，提交代码前最好设置一下提交者的名字与邮箱，方便在commit记录里显示： git config —global user.name "名字" git config —global user.email "邮箱" 通常一次完整的提交过程如下： 将修改过的文件加入暂存区： git add [修改的文件或者目录] # .表示此目录下所有文件，一次提交的文件较多时，可以使用此命令 git add . 确认提交暂存区中的文件： # -m表示附加提交信息，后面的内容是关于提交的信息说明 git commit -m "提交信息" git add是先把改动添加到一个“暂存区”，可以理解成是一个缓存区域，临时保存改动，而git commit才是最后真正的提交。这样做的好处是防止误提交。 最后将代码推送到远程仓库指定分支，即可完成一次代码提（其中注意，最后提交时Gitee与Github的分支名有所不同）： # 推送代码到指定分支 git push origin [分支名] # Github默认分支是main，用以下命令： git push origin main # Gitee默认分支是master，用以下命令： git push origin master 这里的origin是给远程仓库起的名字，当然名字并不唯一，可以是其他名字，只是因为习惯，一般都起名为origin。 一般在多人协作时，为了不产生代码冲突，提交代码前最好进行一次Pull操作： git pull origin [分支名] 查看git仓库当前状态，比如当前所在分支、被修改过的文件、未提交的文件等等： git status 查看提交时产生的所有commit记录： git log 0x07.分支操作 branch即分支的意思，分支的概念在团队协作的时候很重要，假设两个人都在做同一 个项目，这个时候分支就是保证两人能协同合作的最大利器了。举个例子，A, B两人在做同一个项目不同的模块，这个时候A新建了一个分支叫a，B新建了一个分支叫b，这样 A、B做的所有代码改动都在各自的分支上，互不影响，等到都把各自的模块做完 了，最后再统一把分支合并到master主分支。 在本地执行git init命令初始化仓库时默认生成一个主分支master。 而远程仓库的情况就有所不同了，曾经Github远程仓库的默认主分支也是master，但是去年（2020）10月份之后Github将默认主分支名称从master改成了main（据说是因为master这个词意为奴隶的主人，含有种族歧视意味），这也是在前面手动初始化Github仓库时要将主分支名重命名为main的原因。 而Gitee的主分支名称依然是master。 查看分支 查看本地分支列表： git branch 查看远程分支列表： git branch -r 建立新分支 git branch [分支名] 需要注意的是，新创建的分支的内容与当前所在的分支的内容相同，即新分支是基于当前所在的分支而创建的。 当我们建立了新分支以后，默认不会切换到新分支上，当前做出的任何更改还是基于当前所在的分支，所以需要切换分支。 切换分支 git checkout [分支名] # 切换到新分支之后手动拉取最新内容 git pull origin [分支名] 此时进行的改动就是在新分支下面了。当然，也有办法一步到位，加入-b参数即可。 建立并切换到新分支 git checkout -b [分支名] 推送本地分支到远程仓库 在本地建完新分支之后，就可以将本地新分支推送到远程仓库了，以保证两端同步 git push origin [新分支名] 如果本地推送到远程的分支想取另一个名字，那么可以用这条命令： git push origin [本地分支名]:[远程新分支名] 但是强烈不建议这样，这会导致管理混乱，建议本地分支跟远程分支名要保持 一致。 合并分支 当团队中不同成员都完成了开发之后，就可以将改动都合并到一块了。 # 首先切换到要合并到的分支上来，比如master(main)分支或是指定分支 git checkout [分支名]/main/master # 进行合并，将指定分支合并到当前所在的分支（即上一步切换到的分支）上来 git merge [指定分支] 在没有冲突的情况下，代码就可以合并完成了。合并完记得把新代码push到远程仓库。 删除分支 分支建错或者该分支的代码已经顺利合并到其他分支的时候，就可以删除分支了： git branch -d [分支名] 有些时候可能会删除失败，比如该分支的代码还没有合并到master或者其他分支，执行删除分支操作就会失败，Git会提示这个分支上还有未合并的代码，但是也可以强制删除分支： git branch -D [分支名] 以上仅仅为删除本地分支，若要删除远程分支可以可以运行带有 --delete 选项的 git push 命令： git push origin --delete [远程分支名] 重命名分支 将A分支重命名为B分支： git branch -m A B 类似于删除分支，无法重命名时，也可以强制重命名： git branch -M A B 如果是重命名远程分支，推荐的做法是： 删除远程待修改分支 push本地新分支名到远程 0x08.标签操作 开发的时候经常有版本的概念，比如v1.0、v1.1之类的，不同的版本肯定对应不同的代码，所以给代码打上标签，标签名可以是版本号或者其它标记。 Git 支持两种标签：附注标签（annotated）与轻量标签（lightweight）。 附注标签 附注标签是存储在Git数据库中的一个完整对象， 它们是可以被校验的，其中包含打标签者的名字、邮件地址、日期时间， 此外还有一个标签信息，并且可以使用GNU Privacy Guard（GPG）签名并验证。 通常建议创建附注标签，这样就可以拥有以上所有信息 添加附注标签信息用这条命令： git tag -a [标签名] -m "标签信息" -m参数为可选的，表示指定一条存储在标签中的信息。如果省略-m参数，那么Git会自动打开编辑器，让我们写一句标签信息，就像给提交写注解一样。 利用git show命令可以查看标签信息与对应的提交信息： git show [标签名] 输出会显示打标签者的信息、打标签的日期时间、附注信息与具体的提交信息。 轻量标签 如果只是想用一个临时的标签， 或者因为某些原因不想要保存这些信息，那么就可以用轻量标签。 轻量标签很像一个不会改变的分支——它只是某个特定提交的引用。本质上是将提交校验和存储到一个文件中——没有保存任何其他信息。 创建轻量标签，不需要使用 -a、-s 或 -m 选项，只需要提供标签名： git tag [标签名] 同样的，利用git show命令查看标签信息与对应的提交信息，输出只会显示出提交信息，不会看到额外的标签信息。 切换标签 当要切换到某个tag时，命令与切换分支类似： git checkout [标签名]; 推送标签 同样的，向远程仓库推送单个标签的命令与推送分支也是类似的： git push origin [标签名] 如果一次推送多个标签，可以使用带有--tags的git push命令： git push origin --tags 这条命令会将所有不在远程仓库服务器上的标签全部推送到远程仓库。 删除标签 删除本地标签： git tag -d [标签名] 上述命令并不会从远程仓库中移除这个标签，从远程仓库移除标签有两种办法： git push <remote> :[标签名称] 这种操作的含义是，将冒号前面的空值推送到远程标签名，从而实现删除的效果。 第二种方式相对来说更直观： git push origin --delete [标签名] 查看所有标签 执行git tag命令，就可以列出所有标签： git tag 默认是以字母顺序排列标签。 当然，可带上可选的 -l 选项或者 --list选项，以匹配特定标签名： git tag -l "通配符" # 或者 git tag --list "通配符" 例如，只查阅v2.*版本的标签名： git tag -l "v2.*" 给提交打标签 假设在过去某一个时刻提交了项目更改，后期才想起来忘记给项目打标签了，那么也可以在之后补上标签： git tag -a [标签名] [校验和] 与创建标签命令不同，需要在标签名之后添加一个校验和选项（也可以是部分校验和）。 通过以下命令可以查看每一次提交的校验和与对应的提交信息： git log --pretty=oneline 参考资料： 微信公众号 - stormzhang：从0开始学习Github系列文章 Git 教程 | 菜鸟教程 (runoob.com) Git - Book (git-scm.com) 版本控制 - 维基百科，自由的百科全书 (wikipedia.org) git - 维基百科，自由的百科全书 (wikipedia.org) GitHub - 维基百科，自由的百科全书 (wikipedia.org)

在IDEA中配置Maven开发环境 目录： 前言 1. 下载Maven安装文件 2.解压并配置环境变量 2.1、windows端 2.2、Linux端 3.设置IDEA 3.1 修改Maven全局配置文件 3.2 修改路径 3.3 导入Maven依赖 环境说明： 系统：win10专业版 deepin V20 IDE：IDEA 2020.3 java：jdk1.8 Maven：3.8.1 前言 Maven是一个构建自动化工具，主要用于Java项目，由Apache软件基金会托管，它以前是Jakarta项目的一部分。Maven还可用于构建和管理用 C#、Ruby、Scala 和其他语言编写的项目。 Maven解决了构建软件的两个方面：软件是如何构建的，以及它的依赖关系。与早期的工具（如Apache Ant）不同，它对构建过程使用约定，并且只需要写下异常。 XML 文件描述了正在构建的软件项目、它对其他外部模块和组件的依赖、构建顺序、目录和所需的插件。它带有预定义的目标，用于执行某些明确定义的任务，例如代码编译及其打包。 Maven从一个或多个存储库（例如Maven 2 Central Repository）动态下载Java库和Maven插件，并将它们存储在本地缓存中。下载工件的本地缓存也可以使用本地项目创建的工件进行更新。公共存储库也可以更新。 Maven官网：http://maven.apache.org/ 1. 下载Maven安装文件 Maven下载页面：http://maven.apache.org/download.cgi 进入下载页面，根据不同的系统选择前两个二进制文件之一下载就可以了。如果打算自行构建Maven，那就下载后面的源码文件。 2.解压并配置环境变量 部分参考资料：Maven – Installing Apache Maven 2.1、windows端 将下载下来的“.zip”压缩文件解压，这里以解压到“D:\Software”为例进行说明。 “计算机”图标上点击右键->属性->高级系统设置（win10 20H2需要在属性窗口的“相关设置”标签中才能找到高级系统设置），在高级系统设置窗口的右下角点击“环境变量”。 “环境变量”分为两种，一种是“用户变量”，这里面配置的环境变量只适用于当前计算机用户，另一种是“系统变量”，适用于这台计算机上的所有用户。具体设置成哪种环境变量看个人习惯。 添加如下两条环境变量，其中MAVEN_HOME的值是Maven文件的解压路径： 环境变量名称 环境变量值 MAVEN_HOME D:\Software\apache-maven-3.8.1 Path %MAVEN_HOME%\bin 其实第一个环境变量的名称并不是固定的，在其他的配置环境变量的教程中名称也可能不同。这个只是习惯而已，只要保证环境变量值没什么问题即可。 第二条Path也可以写成“D:\Software\apache-maven-3.8.1\bin”，这里引用了上条设置的MAVEN_HOME，表示的是Maven安装路径下的bin文件夹 全都添加完之后，两连“确定”完成环境变量的配置。 2.2、Linux端 Linux下也可以用以下命令下载安装包： wget https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.8.1/binaries/apache-maven-3.8.1-bin.tar.gz 下载下来的是一个后缀名为“.tar.gz”的压缩包。解压压缩包到/usr/下： sudo tar -xvf apache-maven-3.8.1-bin.tar.gz -C /usr/ # 当然解压目录不一定非得是/usr/，换成其他目录也可以，后面配置环境变量时目录就要修改 修改环境变量，编辑/etc/profile文件： sudo nano /etc/profile 在末尾加入以下环境变量，“/usr/apache-maven-3.8.1”是Maven安装文件所在的目录： export PATH=/usr/apache-maven-3.8.1/bin:$PATH 然后ctrl + o保存，ctrl + x退出，再输入以下命令使环境变量生效： source /etc/profile 至此就算配置好了环境变量。使用“mvn -v”命令检验是否配置成功，若无法识别命令，部分Linux环境下可能还需要重启一遍电脑才能生效。 3.设置IDEA 此处以Win10下的IDEA开发环境为例，Linux下相关操作都是一样的。 在cmd控制台窗口中输入以下命令查看Maven版本，检验是否配置成功： mvn -v 没有错误的话，输出结果是这样： 3.1 修改Maven全局配置文件 Maven有一个全局配置文件，里面是Maven的一些设置，该文件存放在Maven安装路径的conf文件夹中，修改的就是这个配置文件。关于这个文件的详解可以看这篇：Maven全局配置文件settings.xml详解 - 洪墨水 - 博客园 (cnblogs.com) Maven需要一个文件夹来存放从Maven仓库下载到本地的依赖包，为了减少对系统盘的空间占用，建议将这个文件夹设置到其他分区。找到配置文件里的settings标签，在标签里面加上： <!-- 中间的路径是本地Maven依赖包的存放路径 --> <localRepository>D:\programmeSoftware\MavenRepository</localRepository> Maven仓库在国外，在国内下载速度比较慢，所以还需要将镜像源更改为国内的镜像源。找到<mirrors>标签，往标签内加入阿里云的镜像源配置： <mirror> <id>nexus-aliyun</id> <name>Nexus aliyun</name> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror> 3.2 修改路径 首先在IDEA中新建一个Maven项目，步骤与新建普通Java项目类似，项目类型选择成Maven。 依次点击“File”->“settings”（或者快捷键Ctrl+Alt+s）打开设置界面，然后选择“Build，Execution，Deployment”->“Maven”，设置如下： “User settings file”是Maven全局配置文件的存放路径，“Local repository”是从Maven仓库下载到本地的依赖包的存放路径。设置完了之后点击右下角“Apply”。 需要注意的是，这个设置仅适用于现在打开的Maven项目，为了将这个更改应用到新建的Maven项目上，还需要再进行设置。依次点击“File”->“New Projects Settings”->“Settings for New Projects...”，同样选择“Build，Execution，Deployment”->“Maven”，进行与上面同样的设置即可。 3.3 导入Maven依赖 Maven仓库地址：Maven Repository: Search/Browse/Explore (mvnrepository.com) 项目里用到的依赖包都是从这个网站上找的，以Mybatis为例，说一下依赖包的导入方式。 在网站顶部的搜索栏中搜索“Mabatis” 选择第一项，然后会看到该软件有很多个不同的版本，版本可以随便选择，但是一般为了防止项目中出现与软件版本相关的这类“玄学问题”，还是选择后面使用人数多的一项吧 点击版本号即可进入该版本界面，复制下方“Maven”标签下的那一串<dependency>标签 然后打开项目根目录下的pom.xml文件，将内容粘贴至<dependencies>（这个是复数的dependency）标签内部，注意缩进。导入依赖的第一步，完成。 当然由于只是导入了配置，本地并没有相应的依赖包，所以会看到粘贴的配置中会有红线报错，碰到报错先别慌，看第二步。此时需要在IDEA中要重载一遍项目的Maven依赖配置。有这么几种方法： 在左侧文件目录中的项目名称上单击右键，依次选择“Maven”->“Reload project” 在IDEA窗口右侧列表找到“Maven”，并单击展开菜单，点击菜单左上角刷新重载按钮 在打开的pom.xml文件界面上单击右键（只有在pom.xml文件上单击右键才可以，其他文件单击右键选项中没有Maven），依次选择“Maven”->“Reload project” 不管使用哪一种方式，最后结果都是窗口右下角会出现一个进度条，开始往本地下载pom.xml文件中导入的依赖项。等待这个进度条走完，原来的报错也就消失了。 在以后修改或添加了Maven依赖以后，都可以用这几种方法重新载入项目的Maven依赖配置。

Maven项目中的MyBatis配置 目录： 一、简介 二、创建项目 2.1、导入 Maven 依赖 2.2、创建 mybatis 核心配置文件 3.3、编写工具类 3.4、编写代码 实体类 Dao 接口 UserMapper 接口实现 UserMapper.xml 3.5、测试 三、问题 1、找不到 mapper.xml 文件 2、SSL 连接问题 环境说明： IDE：IDEA 2020.03 Java：jdk 1.8 MyBatis版本：3.5.3 mysql：5.5 mysql-connector-java：5.1.47 Junit：5.7.0 官方文档： mybatis – MyBatis 3 | 简介 Github 地址： GitHub - mybatis/mybatis-3: MyBatis SQL mapper framework for Java Maven 仓库地址： Maven Repository: org.mybatis » mybatis (mvnrepository.com) 一、简介 MyBatis 是一款优秀的持久层框架 支持自定义 SQL、存储过程以及高级映射。 MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。 MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。 MyBatis 本是 apache 的一个开源项目 iBatis，2010 年这个项目由 apache 迁移到了 google code，并且改名为 MyBatis。 2013 年 11 月迁移到 Github。 二、创建项目 准备数据库，设置字符集与排序规则为 utf-8，否则无法正常插入中文字符。 然后执行以下 SQL 语句： -- 创建表 CREATE TABLE user(id INT NOT NULL AUTO_INCREMENT primary key,name char(20),updateTime datetime); -- 插入两条数据 INSERT INTO user(name,updateTime) value("张三",sysdate()); INSERT INTO user(name,updateTime) value("李四",sysdate()); 并且在 idea 中建好一个 Maven 项目。 2.1、导入 Maven 依赖 项目根目录下的 pom.xml 文件配置 Maven 依赖，在这个配置文件中加入以下依赖的坐标： <dependencies> <!--Mybatis--> <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.3</version> </dependency> <!--mysql驱动--> <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.47</version> </dependency> <!--Junit--> <!-- https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter-api --> <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-api</artifactId> <version>5.7.0</version> <scope>test</scope> </dependency> </dependencies> 2.2、创建 mybatis 核心配置文件 文件名：mybatis-config / mybatis-cfg，或其他 文件模板及说明：mybatis – MyBatis 3 | 入门 <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <settings> <!-- 打印sql日志 --> <setting name="logImpl" value="STDOUT_LOGGING"/> </settings> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <!-- MySQL8.0以下的驱动名叫com.mysql.jdbc.Driver MySQL8.0以上的驱动名是com.mysql.cj.jdbc.Driver --> <property name="driver" value="${driver}"/> <property name="url" value="${url}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> </dataSource> </environment> </environments> <!-- 每一个mapper.xml配置文件都需要在mybaits核心文件中注册 --> <mappers> <!-- 使用文件路径的方式配置 --> <!-- <mapper resource="com/wlplove/dao/AtlasMapper.xml"/> --> <!-- 也可以使用类的方式进行配置 --> <mapper class="com.wlplove.dao.AtlasMapper"/> </mappers> </configuration> 其中，在这个配置文件的 <dataSource> 标签中定义了数据库连接信息，这里将信息写成了固定的死值。还有一种更灵活的方式就是从配置文件中读取信息，在 resources 目录下再新建一个数据库配置文件 jdbc.properties，里面写入数据库信息： # MySQL8.0以下的驱动名叫com.mysql.jdbc.Driver MySQL8.0以上的驱动名是com.mysql.cj.jdbc.Driver driver=com.mysql.cj.jdbc.Driver url=jdbc:mysql://localhost:3306/pic?useSSL=false&useUnicode=true&characterEncoding=UTF-8 username=root password=root # 或者也可以配置成以下形式： #driver:com.mysql.jdbc.Driver #url:jdbc:mysql://localhost:3306/mybatis?useSSL=false&amp;setUnicode=true&characterEncoding=utf8 #username:root #password:root 修改配置文件中的数据库信息部分为引用外部配置： <!-- 配置文件的路径 --> <properties resource="jdbc-config.properties"/> <dataSource type="POOLED"> <!-- MySQL8.0以下的驱动名叫com.mysql.jdbc.Driver MySQL8.0以上的驱动名是com.mysql.cj.jdbc.Driver --> <property name="driver" value="${driver}"/> <!-- 使用属性占位符 ${} 读取 property 文件中的属性 --> <property name="url" value="${url}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> </dataSource> 3.3、编写工具类 将加载 SqlSession 的过程写成一个工具类，方便调用： public class MyBatisUtil { /** * 根据 XML 配置文件初始化出 SqlSessionFactory，并获取到 SqlSession 对象 * @return sqlSession */ public static SqlSession getSqlSession() { SqlSession sqlSession = null; try { String xmlFileResource = "mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(xmlFileResource); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); sqlSession = sqlSessionFactory.openSession(); } catch (Exception e) { e.printStackTrace(); } return sqlSession; } } 3.4、编写代码 实体类 即业务中涉及到的类，并且包括构造方法、getter 方法、setter 方法以及 toString() 方法 public class User { private int id; private String name; private Date updateTime; // 构造方法、set方法、get方法、toString方法略.... } Dao 接口 UserMapper public interface UserMapper { List<User> getUserList(); } 接口实现 UserMapper.xml 原来的 UserDaoImpl 转换为一个接口的 Mapper 映射文件： <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <!-- namespace绑定一个Dao/mapper接口 --> <mapper namespace="com.wlplove.dao.UserMapper"> <!-- 查询语句 --> <!-- 注意其中的id，和resultType返回类型的名称 --> <select id="getUserList" resultType="com.wlplove.pojo.User"> SELECT * FROM mybatis.user; </select> </mapper> 定义好 Mybatis 的这个 Mapper 映射文件之后，需要在 Mybatis 的配置文件中注册一下才能正常调用： <!-- 每一个mapper.xml配置文件都需要在Mybaits核心文件中注册，有这么两种方式注册： --> <mappers> <!-- 使用文件路径的方式 --> <!-- <mapper resource="com/wlplove/dao/AtlasMapper.xml"/> --> <!-- 也可以使用类的方式 --> <mapper class="com.wlplove.dao.AtlasMapper"/> </mappers> 3.5、测试 只要在前面导入了 Junit 的依赖之后，就可以写一个单元测试方法调用写好的接口，单元测试方法没有返回值，没有参数，可以像 main 方法一样直接执行。 class UserMapperTest { // 每一个单元测试方法前面加入 @Test 注解 @Test void getUserList() { // 获取sqlSession对象 SqlSession sqlSession = MybatisUtil.getSqlSession(); // 执行sql UserMapper mapper = sqlSession.getMapper(UserMapper.class); List<User> userList = mapper.getUserList(); for (User user : userList) { System.out.println(user); } // 关闭sqlSession sqlSession.close(); } } 三、问题 1、找不到 mapper.xml 文件 报错信息：Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource com/wlplove/dao/UserMapper.xml 原因是 Maven 在打包的时候，默认打包 src/main/java 下的 class 文件与 src/main/resources 下的配置文件，没有将该路径下的 mapper 配置文件打包进来，导致运行时候找不到 mapper 文件而报错。 解决方法：手动指定资源文件的位置，参考：mybatis：Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource_在路上s的博客-CSDN博客 修改 pom.xml 文件，在里面加入以下内容，然后更新 Maven 配置即可： <build> <!-- **.xml写在src找不到问题解决方案 --> <resources> <resource> <!-- directory：指定资源文件的位置 --> <directory>src/main/java</directory> <includes> <!-- “**” 表示任意级目录 “*”表示任意任意文件 --> <!-- mvn resources:resources　：对资源做出处理，先于compile阶段 --> <include>**/*.properties</include> <include>**/*.xml</include> </includes> <!-- filtering：开启过滤，用指定的参数替换directory下的文件中的参数(eg. ${name}) --> <filtering>false</filtering> </resource> <resource> <directory>src/main/resources</directory> </resource> </resources> </build> 2、SSL 连接问题 报错信息： WARN: Establishing SSL connection without server's identity verification is not recommended. According to MySQL 5.5.45+, 5.6.26+ and 5.7.6+ requirements SSL connection must be established by default if explicit option isn't set. For compliance with existing applications not using SSL the verifyServerCertificate property is set to 'false'. You need either to explicitly disable SSL by setting useSSL=false, or set useSSL=true and provide truststore for server certificate verification. 翻译过来就是： 警告：不建议在没有服务器身份验证的情况下建立SSL连接。根据MySQL 5.5.45+、5.6.26+和5.7.6+的要求，如果没有设置显式选项，则默认情况下必须建立SSL连接。为了符合不使用SSL的现有应用程序，verifyServerCertificate属性设置为“false”。您需要通过设置useSSL=false来显式禁用SSL，或者设置useSSL=true并为服务器证书验证提供信任存储。 在数据库的连接参数中添加不使用 SSL 连接的参数 useSSL=false 即可解决： <property name="url" value="jdbc:mysql://localhost:3306/practice?setUnicode=true&amp;characterEncoding=utf8&amp;useSSL=false"/> 参考： 史上最详细mybatis与spring整合教程-腾讯云开发者社区-腾讯云 (tencent.com)

【踩坑实录】mybatis项目报错：“Caused by: .....Exception: 1 字节的 UTF-8 序列的字节 1 无效” 环境说明： 系统：win10 专业版 开发环境：IDEA JDK版本：1.8 mysql：5.5 mybatis：3.5.3 Junit：5.7.0 问题再现： 运行mybatis项目时，控制台出现报错信息： Caused by: com.sun.org.apache.xerces.internal.impl.io.MalformedByteSequenceException: 1 字节的 UTF-8 序列的字节 1 无效 错误原因： 归根结底是编码的原因，xml文件开头的文档编码设置为了UTF-8： 而由于项目本身的默认编码是GBK，因此xml文件保存时的编码是GBK，声明的xml文档编码与实际编码不一致，就出现了问题 解决方法： 更改项目编码即可。 在IDEA界面打开setting（点击File->setting或者快捷键Ctrl+Alt+S），依次选择Editor->File encodings，将Project Encoding的值从GBK更改为UTF-8。 再次运行，问题消失。

【踩坑实录】Maven项目报错：java.lang.ExceptionInInitializerError 环境说明： 系统：win10 专业版 开发环境：IDEA JDK版本：1.8 mysql：5.5 mybatis：3.5.3 Junit：5.7.0 问题再现： Maven项目运行时报错，控制台报错信息如下： java.lang.ExceptionInInitializerError at com.langp.dao.UserMapperTest.getUserList(UserMapperTest.java:26) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) at java.lang.reflect.Method.invoke(Method.java:498) ······ Caused by: org.apache.ibatis.exceptions.PersistenceException: ### Error building SqlSession. ### The error may exist in com/langp/dao/UserMapper.xml Process finished with exit code -1 错误原因： 程序在编译过程中找不到对应的配置文件就会报错，但是对应的配置文件却是的的确确存在于项目中的，可是在生成的测试结果target对应目录下找不到对应配置文件，这是因为Maven项目中默认资源配置目录是src/main/resource，而实际有些配置文件会放在src/main/java目录下，就会导致项目编译时导出不了这些配置文件。所以我们需要手动配置资源过滤，使src/main/java的”.properties“文件和”.xml“文件可被导出到测试结果的target文件夹中。 解决方法： 最简单的方式就是将对应的Mapper.xml文件复制到生成测试结果的target文件夹下对应的目录中，但是只要在Maven中执行一次clear操作，target文件夹就被清除了，下次编译时还要重新复制过去。所以还有种更简单的方法： 在Maven项目的配置文件”pom.xml“中添加如下过滤配置信息： <!-- 在build中配置resources，来防止资源导出失败的问题 --> <build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.properties</include> <include>**/*.xml</include> </includes> <filtering>true</filtering> </resource> <resource> <directory>src/main/java</directory> <includes> <include>**/*.properties</include> <include>**/*.xml</include> </includes> <filtering>true</filtering> </resource> </resources> </build> 然后，在IDEA中右键依次选择”Maven“->”Reload project“，重新载入依次Maven配置信息即可。