项目网站:[点我前往]
你还在为忘记 git 的命令而发愁吗?
你还要每次执行 git 命令都要去搜索吗?
机会来了!使用中文Git,这些统统不是问题!
赶紧拿起电话订购吧!
Note
本 README 文件内容为直白讲述,如果看不惯请查看 README_DEV 文件。
如果你希望协助更新这些文档以及 中文Git ,请查看CONTRIBUTING文件。感谢您的支持!您的支持是我们继续维护的动力!
项目LICENSE:GPL-2.0
你也可以查看 中文Git 的用户手册来了解更多信息。
中文Git 是一个使用中文命令操作 Git 的简单工具,旨在使不熟悉英文的用户更轻松地使用 Git。
使用 中文Git 可以使用中文指令进行常见的 Git 操作,再也不用去背英文啦!
请前往仓库发行版页下载最新版中文Git。
如果你已有中文Git,只是希望更新,请查看条目如何更新中文Git。
你也可以使用 winget 来获取中文Git,请留意支持 winget 获取的版本。
使用以下命令安装:
winget install DuckStudio.ChineseGit
Tip
设支持的版本号为n,则
在使用 中文Git 前,请确保你有以下依赖,否则 中文Git 将变成废物。
请确保您的系统已配置Python环境,并已安装所需库。
运行以下命令检查Python版本:
python --version
你可能会看到类似这样的输出:
C:\Users\user_name>python --version
Python 3.12.0
运行以下命令以安装所需库:
pip install -r requirements.txt
如果你无法运行指令,请参阅芙芙工具箱文档(懒得再写一个文档了)中的[Q:我该如何添加python到系统PATH环境变量]
对于实在是不会配置(或者根本就是懒)的人,也有个备选方案,你可以前往仓库发行版下载最新版本的压缩包,里面包含打包好的 中文Git.exe 程序。但在执行命令时可能会不一样,详细请参阅下面的如何执行命令。
Tip
使用 winget 获取的不用配置Python。
请确保你的设备中已配置 Git 。
Git是一个版本管理工具...(省略一堆介绍,反正你也知道)...在使用 中文Git 前必须配置 Git 。
运行以下命令以检查:
git -v
如果你看到类似这样的输出则表明你不用管他了:
git version 2.47.1.windows.1
如果你无法运行命令,请下载Git。如果你已下载Git还无法运行命令,请添加Git到环境变量。(看我干嘛,我又没在官方文档中找到如何配置,上面的 Python 怎么配置的 Git 就怎么配置)
Important
此项为必须,即使你使用打包版
一般情况下,你可以使用以下这个命令来使用 中文Git :
python 中文git.py 命令
如果你使用的是打包好的 中文Git ,请用以下命令来使用 中文Git :
path\to\中文git.exe 命令
Note
在使用 python 运行 中文Git 时,请确保 中文git.py 的路径正确!可以使用相对路径。
在使用 打包后的中文Git.exe 运行时,请使用绝对路径
每次都要输这么多的命令...烦死了。
我们来优化一下命令吧!
- 将程序目录添加到系统环境变量
PATH
中。
类似的具体操作请参阅 [芙芙工具箱] Q:我该如何添加python到系统PATH环境变量 - 重启你的设备
- 验证
运行以下命令以验证配置:你应该会看到如下输出:中文git 版本
(版本不一样没关系)中文Git by 鸭鸭「カモ」 版本:v2.x 安装在: D:\...\Chinese_git\中文git.exe git version 2.47.1.windows.1
Warning
此方法可能仅对只传入一个参数时才有效,更多信息请见DuckDuckStudio/Fufu_Tools#97
- 新建一个文件夹,名称随意(这里假设叫
Chinese_git_Script
。很复杂也没事,反正命令用不到) - 在文件夹中新建一个叫
中文git.ps1
的脚本,并在脚本中添加以下内容:
- 对于 py版 :
param(
[string]$command,
[string[]]$inputArgs
)
python "D:\中文Git的完整路径\中文git.py" $command $inputArgs
Warning
如果你创建了虚拟Python环境,请将python
改为虚拟环境中的python.exe
。
示例:
param(
[string]$command,
[string[]]$inputArgs
)
$venv_python = "D:\虚拟环境路径\Scripts\python.exe"
$scriptPath = "D:\完整路径\中文git.py"
& $venv_python $scriptPath $command $inputArgs
- 将我们前面新建好的目录添加到系统环境变量
PATH
中。
类似的具体操作请参阅 [芙芙工具箱] Q:我该如何添加python到系统PATH环境变量 - 重启你的设备
- 验证
运行以下命令以验证配置:你应该会看到如下输出:中文git 版本
(版本不一样没关系)中文Git by 鸭鸭「カモ」 版本:v2.x 安装在: D:\...\Chinese_git\中文git.py git version 2.47.1.windows.1
- 对于
v1.6
及以下版本:
把你旧的 中文Git 删掉换成新的 中文Git 就行。 - 对于
v1.7
-v2.3
版本:- py版
运行命令中文git 更新
。 - 打包版
把你旧的 中文Git 删掉换成新的 中文Git 就行。
- py版
- 对于
v2.4
及以上版本:
运行命令中文git 更新
。
Tip
如果 winget 上有可用的新版本的话,你也可以试试这个命令:
winget update --id DuckStudio.ChineseGit
Note
如果你使用v2.4
及以上版本的打包版中文Git,则你可以cd
到安装目录后运行.\Pack_Version_Update.exe --version vx.y
手动更新中文Git到指定版本,请将命令中的vx.y
替换为你需要更新到的版本。
请注意,自 v2.4 起,中文git的更新程序默认认为中文git叫中文git.py
或中文git.exe
,并不是GitHub发行版上的Chinese_git.py
或Chinese_git.exe
。
这些是在 中文Git 中可以使用的命令,如果你需要的 Git 命令在这里没有列出...快点提交Issues听见没!搞快点!
Tip
这里的可用命令为仓库中最新版本的可用命令,每个Releases的可用命令请查看对应的tag的README/README_DEV/USER_HANDBOOK
。
例如(v1.8的可用命令):
https://github.com/DuckDuckStudio/Chinese_git/blob/v1.8/USER_HANDBOOK.md#可用命令
现在叫啥 | 原来长啥样 | 干啥的 |
---|---|---|
拉取 | pull | 从远程仓库拉取源码 |
推送 | push | 将本地仓库中的提交推送到远程仓库中 |
提交 | commit -m | 提交你的更改 |
新建分支 | checkout -b | 创建一个全新的分支 |
切换分支 / 签出到 | checkout | 我不在这个分支写了!我要去另一个分支写! |
合并 | merge | 混合在一起~ (可能有问题) |
暂存 | add | |
状态 | status | 让我看看!看看你是什么状态! |
日志 | log | 让我看看!看看你之前都提交了什么玩意 |
删除分支 (+确认) | branch -D(-d) | 这个家没有你(删除的分支)的位置了! |
远程地址 | remote -v | 你在另一头(远程)叫什么,住哪里(链接) |
远程分支 | branch -r | 你在另一头(远程)有谁(哪些分支) |
所有分支 | branch -a | 列出仓库的所有分支 |
版本 | -v | 如命令所示,显示你使用的 中文Git 版本与 Git 版本 |
克隆 | clone | 你的代码就是我的!我的代码还是我的! |
图形化日志 | log --graph | 查看图形化的提交日志 |
是否忽略 | check-ignore -v | 看看我有没有把你丢掉 |
初始化 | init | 新 宠 |
本地分支 (+最新提交 +与上游分支关系) | branch (-v/-vv) | 列出所有本地分支(+最新提交 +与上游分支关系) |
强推 | push --force | 让我先拉取再推送?我就不! |
更名分支 | branch -m | 我不叫旧分支名了,我要叫新分支名! |
更新 | / | 我要玩新的中文Git嘛~ |
还原 | revert | 还是以前的好 |
重置 (+保留更改(默认)/+删除更改) | reset (--mixed/--hard) | 把我推到过去,让我重来一次! |
公告 | / | 没人比我更懂中文Git |
差异 | diff | 找 不 同 ~ |
清理引用 | remote prune origin | 清除在远程仓库中不存在的分支 |
Note
对于提交
命令,如果提交信息带空格请用"
将提交信息括起来
对于新建分支
命令,该命令会在新建完分支后自动签出到新分支
$ python 中文git.py 暂存 所有
$ python 中文git.py 提交 更新README
$ python 中文git.py 推送
输出如下:
[Powered by 虚空终端] PS D:\...\Chinese_git> python 中文git.py 暂存 所有
[Powered by 虚空终端] PS D:\...\Chinese_git> python 中文git.py 提交 更新README
[main 11bef48] 更新README
2 files changed, 200 insertions(+), 1 deletion(-)
create mode 100644 "\344\270\255\346\226\207git.py"
[Powered by 虚空终端] PS D:\...\Chinese_git> python 中文git.py 推送
错误: fatal: unable to access 'https://github.com/DuckDuckStudio/Chinese_git.git/': Failure when receiving data from the peer
可以看到推送失败了(倒
请见Issues页。