如何使用 Git 管理 Mdk 工程？
本文轉載自微信公眾號「魚鷹談單片機」，作者魚鷹Osprey。轉載本文請聯系魚鷹談單片機公眾號。
很多初學者都不會使用 git 管理工程，一來不熟悉這個工具，二來不知道使用 git 有什么好處，增加學習成本，當初魚鷹在大學的時候就有了解過 git 這個分布式管理工具，但真正用它管理工程還是在工作一年之后才開始的。
那個時候不知道 git 到底有多香，所以也不會想要真正使用它，最多就是從 github 上下載一些開源項目學習而已。直到跳槽的那個公司使用 git 去管理 STM32 工程，然后到現在差不多使用了兩年的時間，才知道到 git 到底有多香了。
所以即使工作上沒有要求使用 git 管理工程，也建議大家自行使用 git 去管理自己的項目。因為如果只是自己使用的話，是不需要搭建 gitlab 之類的服務器，直接安裝好客戶端在本地管理即可，也不怕上傳公司項目到 github、gitee 服務器上而導致項目泄密的問題。
所以，強烈建議大家使用 git ，除了今天這篇筆記，魚鷹接下來還會介紹一些非常常用的命令來幫助大家快速入手 git。
閑話少說，我們先看看 git 的幾個優點，讓各位道友產生些許興趣。
1、可以查看每一次提交歷史。
這些提交記錄其實是你自己寫的，每一次修改后，為了記錄這次修改，自己寫一點類似注釋的東西，告訴 git 這次做了什么修改，方便后面出現問題追溯。
2、可以對比修改
可以對比每次修改的地方，這樣你可以知道為什么當前代碼出現了問題，而以前代碼沒有問題。
3、可以對比當前修改
當你修改了當前的代碼時，可以告訴你目前做了哪些修改，這樣你可以確定是否需要將這些修改保存提交。
4、無縫銜接 VSCODE
可以使用 VSCode 輕松對比查看修改。
這些優點干巴巴的這樣寫還是比較枯燥的，所以魚鷹會再下一篇筆記中結合命令和實際項目情況詳細介紹。這次就不多說了。
直接進入本篇筆記的主題：如何使用 git 管理 MDK 工程?
MDK 工程有兩個很關鍵的文件，即后綴 .uvoptx 、.uvprojx。所以你的倉庫中必定需要使用 add 命令添加這兩個文件。
其次就是你的 *.h *.c 文件，這些也必須添加(這不是廢話嗎，不然倉庫放啥)。當然如果這些源文件使用了文件夾包含，也會把這些文件夾添加進去的(新建的文件夾只會在 git status 時顯示文件夾，不顯示文件夾內的具體文件，而如果是空文件夾，文件夾也不會顯示，所以你無法添加一個空文件夾。文件夾添加只是順帶的)。
工程里面的其他文件都是不需要的，都是可以由這些文件自動生成，可以不被 git 所追蹤(管理)。這樣你上傳到服務器的空間將大大減小。
比如，Objects 里面的文件，這些都是編譯時自動生成的，不必占用空間。
還有 listings 里面的文件也不需要。
當然，如果說你的分散加載文件 *.sct (Objects 文件夾下)比較特殊，不想使用上面工程文件生成的，那么你也要添加進倉庫里面管理，這樣別人下載你的工程后才能根據這個文件正確編譯(比如自檢代碼時就要特制 sct 文件)。
使用 jlink 下載時，會生成兩個文件：
這兩個文件沒啥用，就不用添加了，也可以自己生成。如果你有批處理文件，比如刪除中間文件的批處理，那么也可以添加進倉庫。
如果你使用了 MDK 的 *.ini 文件，那么這個也需要。這個可不是自動生成的。比如 RAM 運行時用的配置文件。
你的工程可能使用 readme.txt ，那么這個也需要添加?？傊粋€原則是，只保留必須的，可以自動生成的非特殊文件都可以不添加進倉庫占用空間。
那么如何保證 git 忽略那些不需要的文件呢?
其實你只要 add 你需要的文件就可以了，但這樣一來，git 會一直提示你有哪些文件并沒有添加到倉庫中，問你是否需要添加進去，這樣就很煩，所以就有一個 .gitignore 文件用來忽略這些不希望跟蹤的文件。
特別注意的是，這個文件很特殊，它的后綴就是 .gitignore ，不是你認為的 txt 之類的后綴，而且沒有文件名。所以如果說你新建了這個文件，又添加了忽略文件，但是 git status 還是顯示了這些文件，那么就要好好檢查你這個文件名是否正確了(只要有這個文件，立即生效)。當然你也要把它 add 進倉庫，不然別人下載后就沒有這個文件了，也就無法忽略那些文件。
那么這個文件可以添加什么內容呢?如下：
- ##########################################
- #git add .
- #git commit -m 'update .gitignore'
- ##########################################
- !debug.ini # 該文件不忽略
- *.ini
- JLinkLog.txt
- Listings
- DebugConfig
- Objects
- .vscode
- *.uvguix.*
- *.si4project
- SI
- *.TMP
- *.hex
- *.map
- *.lnp
- *.htm
- *.sct
- ExtDll.iex
這里加一個 ! 代表這個 debug.ini 文件不忽略，而后面的 .ini 表示所有這類后綴文件都會被忽略。也就是說，.ini 文件里面只有 debug.ini 不能忽略，其它都忽略，比如前面的 RAM.ini。
Objects 代表這個文件夾內所有文件都忽略。
后面都是類似的。
還有要注意的是，如果你忽略的文件前沒有加路徑，那么它將忽略本目錄和子目錄下所有的同后綴名文件。而一旦加了路徑，比如 USER/*.txt(注意必須是斜桿)，那么只會忽略這個目錄 USER 下的同后綴文件(不忽略子文件夾下的)。
以上就是魚鷹想分享的 MDK 管理內容，建議大家嘗試 git 管理項目，別再用復制文件夾這種效率低下的方式管理了。而當你需要維護多個定制化的客戶項目時(大部分功能相同，只有少部分有差異的項目)，你就會發現 git 是真的香。
