项目网站:[点我前往]
Tip
你可以使用 winget 来安装中文Git了!!!
这是 中文Git 的用户手册,你可以在这里找到一些关于 中文Git 的使用方法。
请前往仓库发行版页下载最新版中文Git。
如果你已有中文Git,只是希望更新,请查看条目如何更新中文Git。
你也可以使用 winget 来获取中文Git,请留意支持 winget 获取的版本。
使用以下命令安装:
winget install DuckStudio.ChineseGit
Tip
使用 winget 获取的不用配置Python。
支持 winget 安装的版本有:
在使用 中文Git 前,你必须先配置好 Git 。中文Git 只是一个帮你用中文命令来执行 Git 命令的工具,不能代替 Git 。
运行以下命令以检查:
git -v
如果输出类似于以下内容,则说明无需进行更改:
C:\Users\user_name>git -v
git version 2.42.0.windows.1
如果无法执行命令:
- 未下载 Git
请 下载Git 。 - 已下载 Git
请 将Git添加到环境变量 (方法可自行百度,添加完后若未起效请重启您的设备)
如果你希望从源码 (中文git.py
) 使用 中文Git ,请先配置好 Python。
运行以下命令以检查:
python --version
你可能会看到类似这样的输出:
C:\Users\user_name>python --version
Python 3.12.0
运行以下命令以安装所需库:
pip install -r requirements.txt
如果无法执行命令:
- 未下载 Python 解释器
请 下载Python 。 - 已下载 Python 解释器
请 将Python添加到环境变量 (具体请参阅[Q:我该如何添加Python到系统PATH环境变量])
在您配置完这些依赖后,您应该就可以正常的使用 中文Git 了。
目前来看,你似乎可以使用 中文Git 的Python源码来在 Linux 和 macos 系统上运行 中文Git ,但是我没试过,所以不能保证稳定性。
每次都要输这么多的命令...烦死了。
我们来优化一下命令吧!
- 新建一个文件夹,名称随意(这里假设叫
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
- 对于 打包版 :
param(
[string]$command,
[string[]]$inputArgs
)
D:\中文Git的完整路径\中文git.exe $command $inputArgs
也可以对更新程序的命令进行简化,如果你有需要的话。新建一个更新中文git.ps1
,并添加以下内容:
param(
[string]$command,
[string[]]$inputArgs
)
D:\打包版中文Git的更新程序的完整路径\中文git更新程序.exe $command $inputArgs
- 将我们前面新建好的目录添加到系统环境变量
PATH
中。
类似的具体操作请参阅 [芙芙工具箱] Q:我该如何添加python到系统PATH环境变量 - 重启你的设备。
- 验证
运行以下命令以验证配置:你应该会看到如下输出:中文git 版本
(版本不一样没关系)中文Git by 鸭鸭「カモ」 版本:v2.x 安装在: D:\Duckhome\projects\MSVS\Source\Repos\Chinese_git\Script\中文git\中文git.py git version 2.42.0.windows.1
这样,你就可以不用在每次执行 中文Git 时都使用完整路径了,您只需使用以下代码即可:
中文git 命令
请将命令
替换为你需要执行的 中文Git 的命令,详细可用命令请查看下方的 可用命令 条目
以下是 中文Git 目前的可用命令,如需添加更多命令请提交 Issues 或者 PR
关于如何贡献,请查看CONTRIBUTING文件。
Tip
这里的可用命令为仓库中最新版本的可用命令,每个Releases的可用命令请查看对应的tag的README/README_DEV/USER_HANDBOOK。
例如(v1.8的可用命令):
https://github.com/DuckDuckStudio/Chinese_git/blob/v1.8/USER_HANDBOOK.md#可用命令
在中文Git中的命令 | 在Git中的命令 | 用途 |
---|---|---|
拉取 | pull | 从远程仓库拉取源码 |
推送 | push | 将本地仓库中的提交推送到远程仓库中 |
提交 | commit -m | 提交您的更改 |
新建分支 | checkout -b | 创建一个全新的分支 |
切换分支 / 签出到 | checkout | 切换到另一个分支 |
合并 | merge | 合并分支(可能会产生冲突) |
暂存 | add | 暂存您的修改以备提交 |
状态 | status | 查看当前仓库状态 |
日志 | log | 查看提交日志 |
删除分支 (+确认) | branch -D(-d) | 删除指定分支(+合并检查) |
远程地址 | remote -v | 查看远程仓库地址 |
远程分支 | branch -r | 查看远程仓库的分支列表 |
版本 | -v | 显示中文Git版本和Git版本 |
克隆 | clone | 克隆远程仓库到本地 |
图形化日志 | log --graph | 查看图形化的提交日志 |
是否忽略 | check-ignore -v | 检查文件/文件夹是否被.gitignore 忽略 |
初始化 | init | 初始化一个新的 Git 仓库 |
本地分支 (+最新提交 +与上游分支关系) | branch (-v/-vv) | 列出所有本地分支(+最新提交 +与上游分支关系) |
强推 | push --force | 将本地仓库的提交强制推送到远程仓库中 |
更名分支 | branch -m | 修改本地仓库分支名 |
更新 | / | 更新 中文Git |
还原 | revert | 新建一个提交来撤销指定提交所做的更改 |
重置 (+保留更改(默认)/+删除更改) | reset (--mixed/--hard) | 移动 HEAD 指针以及修改暂存区和工作目录中的文件状态 |
公告 | / | 显示中文Git版本的最新公告 |
差异 | diff | 显示文件间的差异 |
清理本地分支 | remote prune origin | 清除在远程仓库中不存在的分支 |
Note
对于提交
命令,如果提交信息带空格请用"
将提交信息括起来
对于新建分支
命令,该命令会在新建完分支后自动签出到新分支
- 对于
v1.6
及以下版本:
把你旧的 中文Git 删掉换成新的 中文Git 就行。 - 对于
v1.7
-v2.3
版本:- py版
运行命令中文git 更新
。 - 打包版
把你旧的 中文Git 删掉换成新的 中文Git 就行。
- py版
- 对于
v2.4
及以上版本:
运行命令中文git 更新
。
Note
如果你使用v2.4
及以上版本的打包版中文Git,则你可以cd
到安装目录后运行.\Pack_Version_Update.exe --version vx.y
手动更新中文Git到指定版本,请将命令中的vx.y
替换为你需要更新到的版本。
以下是 中文Git 目前的已知问题:
- 在使用 中文Git 执行部分命令时不会有输出,但命令成功执行
中文Git 的所有项目文件源码以及发行版文件均使用 UTF-8 编码,如出现乱码请使用 UTF-8 编码而非简体中文系统默认的 GBK 编码。