中文Git

项目网站：[点我前往]

你还在为忘记 git 的命令而发愁吗？
你还要每次执行 git 命令都要去搜索吗？
机会来了！使用中文Git，这些统统不是问题!
赶紧拿起电话订购吧！

Note

本 README 文件内容为直白讲述，如果看不惯请查看 README_DEV 文件。
如果你希望协助更新这些文档以及 中文Git ，请查看CONTRIBUTING文件。感谢您的支持！您的支持是我们继续维护的动力！
项目LICENSE：GPL-2.0
你也可以查看 中文Git 的用户手册来了解更多信息。

项目介绍

中文Git 是一个使用中文命令操作 Git 的简单工具，旨在使不熟悉英文的用户更轻松地使用 Git。
使用 中文Git 可以使用中文指令进行常见的 Git 操作，再也不用去背英文啦！

如何获取

请前往仓库发行版页下载最新版中文Git。
如果你已有中文Git，只是希望更新，请查看条目如何更新中文Git。

使用 winget

你也可以使用 winget 来获取中文Git，请留意支持 winget 获取的版本。
使用以下命令安装:

winget install DuckStudio.ChineseGit

输出类似这样:

Tip

设支持的版本号为n，则 $2.4⩽n⩽2.10$
winget会错误的将版本2.10显示为版本2.1，更多信息请见microsoft/winget-pkgs#196868

项目依赖

在使用 中文Git 前，请确保你有以下依赖，否则 中文Git 将变成废物。

Python

请确保您的系统已配置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 。
运行以下命令以检查：

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 运行时，请使用绝对路径

优化

每次都要输这么多的命令...烦死了。
我们来优化一下命令吧！

打包版

1. 将程序目录添加到系统环境变量PATH中。
   类似的具体操作请参阅 [芙芙工具箱] Q：我该如何添加python到系统PATH环境变量
2. 重启你的设备
3. 验证
   运行以下命令以验证配置:

   中文git 版本
   你应该会看到如下输出:

   中文Git by 鸭鸭「カモ」
   版本：v2.x
   安装在: D:\...\Chinese_git\中文git.exe
   git version 2.47.1.windows.1
   
   
   (版本不一样没关系)

源码

Warning

此方法可能仅对只传入一个参数时才有效，更多信息请见DuckDuckStudio/Fufu_Tools#97

1. 新建一个文件夹，名称随意(这里假设叫Chinese_git_Script。很复杂也没事，反正命令用不到)
2. 在文件夹中新建一个叫中文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

3. 将我们前面新建好的目录添加到系统环境变量PATH中。
   类似的具体操作请参阅 [芙芙工具箱] Q：我该如何添加python到系统PATH环境变量
4. 重启你的设备
5. 验证
   运行以下命令以验证配置:

   中文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 就行。
• 对于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	混合在一起~
变基	rebase	变基合并分支
暂存	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	找 不 同 ~
清理	clean	不要了，扔掉
清理引用	remote prune	清除在远程仓库中不存在的分支
配置	config	让我调调

Tip

在 README_DEV 和 用户手册 中有更详细的说明。这里的只是开个玩笑。

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页。