使用MATLAB自带的Git管理本地工程

前言

神器Git，绝对是写代码，特别是做项目必不可少的东西。而大概是2014版之后（DeepSeek是这么告诉我的），MATLAB自带了Git，不需要下载即可使用。

一、创建本地源代码管理

1. 在“主页”的“预设项”里打开。
   
   

2. 在MATLAB中进入待管理的文件夹。
   

3. 点击：主页 --> 新建 --> 工程 --> 空白工程。
   
   然后输入“工程名称”，并将“工程文件夹”改为带管理的文件夹位置。

4. 创建好空白工程后，点击工程文件 .prj。
   

5. 在上方选择使用源代码管理 --> 将工程添加到源代码管理 --> 转换，即可进源代码本地管理了。
   
   如下图所示即为成功对该文件夹进行源代码管理
   

二、MATLAB中源代码管理的基本操作

文件状态

进行源代码管理的文件夹内每一个文件后都会有一个标记，我们需要了解每一个标记的含义，下图中，有4中标记，他们各自的含义为，

• 绿色圆圈——已经提交了
• 蓝色方块——有修改，与最新的提交版本不同
• 黑色加号——刚添加进了Git，还没有提交过
• 白色圆圈——没有添加进Git，未进行源代码管理
  

新建操作

新建一个脚本（或函数）后，这个脚本并没有进行源代码管理，此时可发现其状态是一个白圈，如下图中的test2.m脚本。

若我们需要对他进行源代码管理，则需右击该脚本，点击“源代码管理”、点击“添加到Git”。

提交操作

打开工程，在工具栏里有一个“提交”，点击，然后输入注释即可提交。
注意：“提交”会将目前修改的所有文件全部提交。

比较操作

右击文件，例如test.m脚本，点击源代码管理，有三个类似的选项：显示修订版本、与前代比较 和 与修订版比较，三者类似，建议选择“显示修订版”。
可以看到，将会显示已提交的各个历史版本的信息，其中“消息”即为提交时所写的“注释”。然后选择需要比较的版本，再点击下方“与本地文件比较”即可。

下图即在显示两个版本之间的差异。

还原操作

当你目前的代码出现问题，就需要利用还原回到旧的版本。和比较操作一样，假设我们现在需要还原test.m脚本，前面的步骤都和比较的一样：右击该文件然后点击源代码管理，再点击显示修订版，唯一的区别是最后一步点击还原，而“非与本地文件比较”。
注意：“还原”只会还原你右击选择的这一个文件。而且还原后，你之前的修改则会被删除，因此在还原之前必须确保目前的修改已经作废，否则的话，就需要先暂存。

暂存文件

若在还原时，你已经修改的文件仍需要保留，则可以选择暂存文件。
首先打开工程，然后点击“暂存文件”，再点击“新建暂存文件”即可将目前所有已经修改的文件暂存并还原到最新提交的版本。

图中绿框区域将会显示当前暂存文件的日期，以及暂存的文件有哪些。

而后，如需要再使用暂存的文件则需如上一般打开“暂存文件”，然后在下图中红框处选择需要的暂存文件，然后点击蓝框中的按钮，其中

• 恢复：将使用暂存的文件并删除暂存文件
• 引用：仅仅使用暂存文件，但不删除暂存文件
• 丢弃：不使用暂存文件，且删除暂存文件
  

分支操作

打开工程，点击“分支”
如下图所示，红色显示当前所在分支，绿色则用于选择不同分支进行切换与合并，紫色区域是一些具体信息，蓝色区域适用于创建分支或者标签。

如下图所示，绿色表示不同分支的头指针名字，其中main（或者master）是主分支，1111为我创建的一个分支，而HEAD是表示当前位置的指针，图中HEAD和main一起，则说明当前处于main支上。

总结

若是多人的、大型的项目，Git的使用还会设计远程库，推送、提取等操作，不过不在本文介绍范围。

本文主要还是介绍了一些MATLAB中使用Git的来帮助个人完成一些小型的、本地的项目。初学者，强烈建议多用几个测试文件夹和测试文件操作几遍，多了解一下各个操作导致的变化和影响，然后在实际项目中，对于不确定后果的操作，最好是建一个测试文件试试，防止误删了自己的重要代码。

补充-20260329

撤销提交操作

在绿色框中打开“全部”峰值可以在蓝色框中看到目前所有的分支情况，目前代码有三个版本，而红色框中显示了第三版1是在第二版基础上，修改了main脚本和func1函数得到的。

然后在MATLAB的命令行窗口输入!git reset --soft HEAD~1，即可撤回提交。这种修改是最常用、最安全的方法，撤销提交后，所有更改会回到提交之前的状态，最新的提交被移除但文件基于上一版进行的修改都仍然保留在工作区。
（注意：代码中的感叹号，需使用英文输入法中的）

另外，还有一种更彻底的撤销是使用!git reset --hard HEAD~1，这不仅会撤销提交，所有更改还会回到上一次提交的状态，基于上一版本进行所有的修改都将丢弃，因此请谨慎使用！

在这之后，当再次提交，打开全部分支可以发现，上一次提交的第三版1作为一个废弃分支扔掉，新提交的第三版2作为master主分支，被头指针HEAD指着。

Git常用的操作基本就是以上这些，另外还有一些更深入、更具体的操作，可以通过在MATLAB命令行中输入!git简单了解。