Henry Zhu / Site Title

Git常用命令实用指南

2026-01-30T00:00:00-08:00

Git 是目前世界上最流行的分布式版本控制系统。它不仅能够高效地处理从小型到大型项目的各种版本管理需求，还提供了强大的分支管理、协作开发和历史追溯功能。本文将重点介绍 Git 的常用命令和实用技巧，帮助您在日常开发中更高效地使用 Git。

核心概念

在使用 Git 之前，理解以下核心概念至关重要：

工作区 (Working Directory):
- 您当前正在编辑的文件所在目录。
- 这里的文件是可见的，但尚未被 Git 跟踪或暂存。
暂存区 (Staging Area/Index):
- 也称为索引区，是 Git 的一个中间区域。
- 通过 git add 命令将文件从工作区添加到暂存区。
- 暂存区的文件将被包含在下一次提交中。
本地仓库 (Local Repository):
- 通过 git commit 命令将暂存区的内容提交到本地仓库。
- 包含项目的完整历史记录和版本信息。
远程仓库 (Remote Repository):
- 托管在远程服务器（如 GitHub、GitLab）上的仓库。
- 通过 git push 和 git pull 命令与本地仓库同步。

Git 基本指令

一、初始化与配置

指令	作用	备注
`git init`	在当前目录初始化一个新的 Git 仓库。	创建一个 `.git` 隐藏目录，用于存储 Git 数据。
`git clone [仓库地址]`	克隆远程仓库到本地。	例如：`git clone https://github.com/user/repo.git`。
`git config --global user.name "姓名"`	设置全局用户名。	用于标识提交者。
`git config --global user.email "邮箱"`	设置全局邮箱。	用于标识提交者。
`git config --list`	查看当前 Git 配置。

二、基本操作

指令	作用	备注
`git status`	查看工作区和暂存区的状态。	显示哪些文件被修改、哪些文件被暂存、哪些文件未被跟踪。
`git add [文件名]`	将文件添加到暂存区。	例如：`git add file.txt` 或 `git add .`（添加所有文件）。
`git commit -m "提交信息"`	将暂存区的内容提交到本地仓库。	提交信息应简洁明了，描述本次提交的内容。
`git commit -am "提交信息"`	跳过暂存区，直接提交所有已跟踪文件的修改。	只适用于已跟踪的文件，新文件仍需先 `git add`。
`git log`	查看提交历史。	显示提交的哈希、作者、日期和提交信息。
`git log --oneline`	以简洁的一行格式查看提交历史。	只显示提交哈希的前几位和提交信息。

三、分支管理

指令	作用	备注
`git branch`	查看本地分支列表。	当前分支前会有 `*` 标记。
`git branch [分支名]`	创建新分支。	例如：`git branch feature-login`。
`git checkout [分支名]`	切换到指定分支。	例如：`git checkout feature-login`。
`git checkout -b [分支名]`	创建并切换到新分支。	例如：`git checkout -b feature-login`。
`git branch -d [分支名]`	删除已合并的分支。	例如：`git branch -d feature-login`。
`git branch -D [分支名]`	强制删除分支（即使未合并）。	请谨慎使用。
`git merge [分支名]`	将指定分支合并到当前分支。	例如：`git merge feature-login`。
`git merge --no-ff [分支名]`	以非快进方式合并分支，保留分支历史。	适用于需要保留分支结构的场景。

四、远程操作

指令	作用	备注
`git remote -v`	查看远程仓库信息。	显示远程仓库的名称和 URL。
`git remote add [名称] [URL]`	添加远程仓库。	例如：`git remote add origin https://github.com/user/repo.git`。
`git push [远程名] [分支名]`	将本地分支推送到远程仓库。	例如：`git push origin main`。
`git push -u [远程名] [分支名]`	推送并设置上游分支。	下次推送时只需 `git push`。
`git pull [远程名] [分支名]`	从远程仓库拉取并合并到本地分支。	相当于 `git fetch` + `git merge`。
`git fetch [远程名]`	从远程仓库获取最新数据，但不合并。	可以先查看远程更新，再决定是否合并。

五、撤销与恢复

指令	作用	备注
`git checkout -- [文件名]`	撤销工作区中文件的修改（恢复到暂存区或上一次提交的状态）。	例如：`git checkout -- file.txt`。
`git reset HEAD [文件名]`	将文件从暂存区移除，但保留工作区的修改。	例如：`git reset HEAD file.txt`。
`git reset --soft HEAD~1`	撤销上一次提交，但保留修改在暂存区。	适用于重新提交。
`git reset --mixed HEAD~1`	撤销上一次提交，将修改保留在工作区（默认）。
`git reset --hard HEAD~1`	撤销上一次提交，并丢弃所有修改。	请谨慎使用，修改将无法恢复。
`git revert [提交哈希]`	创建一个新的提交，撤销指定提交的修改。	保留完整历史，推荐用于公共分支。

六、查看与比较

指令	作用	备注
`git diff`	查看工作区与暂存区的差异。
`git diff --cached`	查看暂存区与本地仓库的差异。
`git diff [分支A] [分支B]`	查看两个分支之间的差异。	例如：`git diff main feature-login`。
`git show [提交哈希]`	查看指定提交的详细信息。	显示提交的修改内容、作者、日期等。
`git blame [文件名]`	查看文件每一行的修改历史。	显示每一行是由谁、在哪个提交中修改的。

常用场景示例

场景 1: 开始新项目

# 初始化仓库
git init

# 添加所有文件
git add .

# 提交
git commit -m "Initial commit"

# 添加远程仓库
git remote add origin https://github.com/user/repo.git

# 推送到远程
git push -u origin main

场景 2: 开发新功能

# 创建并切换到新分支
git checkout -b feature-login

# 进行开发，修改文件

# 查看状态
git status

# 添加修改的文件
git add .

# 提交
git commit -m "Add login feature"

# 切换回主分支
git checkout main

# 合并功能分支
git merge feature-login

# 推送到远程
git push origin main

# 删除功能分支
git branch -d feature-login

场景 3: 修复错误

# 发现错误，查看修改
git diff

# 撤销某个文件的修改
git checkout -- file.txt

# 如果已经提交，可以使用 revert
git revert HEAD

# 或者使用 reset（谨慎使用）
git reset --hard HEAD~1

场景 4: 协作开发

# 拉取最新代码
git pull origin main

# 创建分支进行开发
git checkout -b feature-new

# 开发并提交
git add .
git commit -m "Add new feature"

# 推送分支到远程
git push -u origin feature-new

# 在 GitHub 上创建 Pull Request
# 等待代码审查和合并

Git 配置优化

1. 设置别名

为常用命令设置别名，提高效率：

git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.unstage 'reset HEAD --'
git config --global alias.last 'log -1 HEAD'
git config --global alias.visual '!gitk'

使用示例：

git st          # 等同于 git status
git co main     # 等同于 git checkout main
git ci -m "msg" # 等同于 git commit -m "msg"

2. 设置默认分支名

将默认分支名从 master 改为 main：

git config --global init.defaultBranch main

3. 配置编辑器

设置 Git 使用的默认编辑器：

# 使用 VS Code
git config --global core.editor "code --wait"

# 使用 Vim
git config --global core.editor "vim"

# 使用 Notepad++ (Windows)
git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"

4. 配置差异工具

设置图形化的差异比较工具：

# 使用 VS Code
git config --global diff.tool vscode
git config --global difftool.vscode.cmd 'code --wait --diff $LOCAL $REMOTE'

# 使用 Beyond Compare (Windows)
git config --global diff.tool bc3
git config --global difftool.bc3.cmd '"C:/Program Files/Beyond Compare 3/BCompare.exe" "$LOCAL" "$REMOTE"'

高级技巧

1. 交互式暂存

使用 git add -i 进入交互式暂存模式，可以选择性地暂存文件的某些部分：

git add -i

或者使用 git add -p 逐块查看和暂存修改：

git add -p

2. 储藏 (Stash)

临时保存工作区的修改，以便切换分支或处理其他任务：

# 保存当前修改
git stash

# 查看储藏列表
git stash list

# 应用最近的储藏
git stash pop

# 应用指定的储藏
git stash apply stash@{0}

# 删除储藏
git stash drop stash@{0}

# 清除所有储藏
git stash clear

3. 变基 (Rebase)

使用变基来整理提交历史：

# 将当前分支变基到 main 分支
git rebase main

# 交互式变基，可以修改提交历史
git rebase -i HEAD~3

4. 挑选 (Cherry-pick)

将某个提交应用到当前分支：

git cherry-pick [提交哈希]

5. 标签 (Tag)

为重要的版本打标签：

# 创建轻量标签
git tag v1.0.0

# 创建带注释的标签
git tag -a v1.0.0 -m "Version 1.0.0 release"

# 查看标签
git tag

# 推送标签到远程
git push origin v1.0.0

# 推送所有标签
git push origin --tags

常见问题解决

1. 合并冲突

当合并分支时出现冲突，Git 会标记冲突的文件：

# 查看冲突文件
git status

# 手动编辑文件，解决冲突
# 保留需要的代码，删除冲突标记

# 添加解决后的文件
git add [冲突文件]

# 完成合并
git commit

2. 撤销已推送的提交

如果已经推送到远程，需要谨慎处理：

# 方法 1: 使用 revert（推荐）
git revert HEAD
git push origin main

# 方法 2: 使用 reset（需要强制推送，谨慎使用）
git reset --hard HEAD~1
git push -f origin main

3. 忘记添加文件到提交

如果提交后发现忘记添加某个文件：

# 添加忘记的文件
git add forgotten-file.txt

# 修改上一次提交
git commit --amend --no-edit

4. 查看文件历史

查看某个文件的修改历史：

# 查看文件的提交历史
git log --follow [文件名]

# 查看文件每次提交的差异
git log -p [文件名]

总结

Git 是现代软件开发中不可或缺的工具。通过本文介绍的常用命令和技巧，您可以：

熟练使用 Git 的基本操作（初始化、提交、分支、合并等）
高效地进行团队协作开发
灵活地处理各种版本控制场景
配置和优化 Git 以适应个人工作习惯
解决常见的 Git 使用问题

掌握 Git 不仅能够提高开发效率，还能帮助您更好地管理项目历史和协作流程。建议在实际项目中多加练习，逐步深入理解 Git 的工作原理和高级功能。

无论您是个人开发者还是团队成员，熟练使用 Git 都将为您的开发工作带来巨大的便利。

Hugging Face CLI (hf命令) 实用指南

2026-01-17T00:00:00-08:00

huggingface-cli 是 Hugging Face 官方提供的命令行工具，用于与 Hugging Face Hub 进行交互。随着其功能的不断增强，现在已更名为 hf 命令，提供了更简洁、强大的接口。本文将重点介绍 hf 命令的具体用法，包括如何使用 hf-mirror 镜像加速下载，以及其他实用的加速措施。

核心功能

hf 命令行工具的核心功能包括：

模型和数据集管理: 下载、上传、列出 Hugging Face Hub 上的模型和数据集。
空间管理: 创建和管理 Hugging Face Spaces（用于部署模型和应用）。
认证管理: 处理用户登录和令牌管理。
配置管理: 设置和查看工具配置。
镜像加速: 支持使用镜像源加速下载。

安装 `hf` 命令

从 PyPI 安装

pip install -U huggingface_hub

安装完成后，您可以通过以下命令验证安装是否成功：

hf --version

基本认证

在使用 hf 命令与 Hugging Face Hub 交互之前，您需要进行认证：

hf login

这将打开浏览器窗口，引导您完成登录过程。如果您在没有图形界面的环境中，可以使用令牌进行认证：

hf login --token YOUR_TOKEN_HERE

`hf` 命令基本用法

1. 模型和数据集管理

下载模型

# 下载完整模型
hf download username/model-name

# 下载特定文件
hf download username/model-name --include "*.bin"

# 下载到指定目录
hf download username/model-name --local-dir ./my-model

上传模型

hf upload username/model-name ./my-model

列出模型

hf list models --filter "text-generation"

2. 空间管理

创建空间

hf space create --name my-space --type model

部署到空间

hf space deploy --space username/my-space

3. 配置管理

查看配置

hf config

设置配置

hf config set cache_dir /path/to/cache

使用 hf-mirror 镜像加速

由于网络原因，直接从 Hugging Face Hub 下载可能会很慢。使用 hf-mirror 镜像是最有效的加速方法之一。

临时使用镜像

在执行命令时通过环境变量指定：

# Linux/MacOS
export HF_ENDPOINT=https://hf-mirror.com && hf download username/model-name

# Windows (PowerShell)
$env:HF_ENDPOINT="https://hf-mirror.com"; hf download username/model-name

# Windows (CMD)
set HF_ENDPOINT=https://hf-mirror.com && hf download username/model-name

永久设置镜像

将镜像设置添加到配置文件中：

hf config set endpoint https://hf-mirror.com

或者直接编辑配置文件 ~/.cache/huggingface/token，添加：

endpoint = https://hf-mirror.com

其他加速措施

1. 配置缓存目录

设置较大的缓存目录，避免重复下载：

hf config set cache_dir /path/to/large-cache

2. 使用 `--resume-download` 参数

在下载大文件时启用断点续传：

hf download username/model-name --resume-download

3. 批量下载优化

对于多个文件的下载，使用 --include 或 --exclude 参数精确控制：

hf download username/model-name --include "*.bin" "*.json"

4. 并行下载

使用 --parallel 参数启用并行下载（需要较新版本的 huggingface_hub）：

hf download username/model-name --parallel

5. 使用系统代理

如果您有可用的代理，可以通过环境变量设置：

# HTTP 代理
export HTTP_PROXY=http://proxy-server:port
export HTTPS_PROXY=http://proxy-server:port

# SOCKS 代理
export ALL_PROXY=socks5://proxy-server:port

6. 使用 hf-transfer 加速

hf-transfer 是 Hugging Face 官方开发的高性能下载加速工具，通过多线程和断点续传技术显著提高下载速度。

安装 hf-transfer

pip install hf-transfer

启用 hf-transfer

安装完成后，通过设置环境变量启用：

# Linux/MacOS
export HF_HUB_ENABLE_HF_TRANSFER=1 && hf download username/model-name

# Windows (PowerShell)
$env:HF_HUB_ENABLE_HF_TRANSFER=1; hf download username/model-name

# Windows (CMD)
set HF_HUB_ENABLE_HF_TRANSFER=1 && hf download username/model-name

永久启用 hf-transfer

将环境变量添加到系统配置文件中：

# Linux/MacOS: 添加到 ~/.bashrc 或 ~/.zshrc
echo 'export HF_HUB_ENABLE_HF_TRANSFER=1' >> ~/.bashrc
source ~/.bashrc

# Windows: 在系统环境变量中添加
# HF_HUB_ENABLE_HF_TRANSFER = 1

与镜像结合使用

hf-transfer 可以与 hf-mirror 镜像结合使用，获得最佳下载速度：

export HF_ENDPOINT=https://hf-mirror.com && export HF_HUB_ENABLE_HF_TRANSFER=1 && hf download username/model-name

常用场景示例

场景 1: 快速下载大模型

# 使用镜像和 hf-transfer 加速下载 Llama 3 模型
export HF_ENDPOINT=https://hf-mirror.com && export HF_HUB_ENABLE_HF_TRANSFER=1 && hf download meta-llama/Llama-3-8B --local-dir ./llama3

场景 2: 上传本地模型到 Hub

# 登录后上传模型
hf login
hf upload my-username/my-model ./local-model

场景 3: 批量下载数据集

# 使用镜像加速下载 GLUE 数据集
export HF_ENDPOINT=https://hf-mirror.com && export HF_HUB_ENABLE_HF_TRANSFER=1 && hf download --repo-type dataset glue --local-dir ./glue-dataset

高级配置

配置文件结构

hf 命令的配置文件位于 ~/.cache/huggingface/token，您可以手动编辑它来设置更多选项：

[DEFAULT]
endpoint = https://hf-mirror.com
cache_dir = /path/to/cache
user_agent = hf-cli/0.1.0

环境变量优先级

配置的优先级从高到低为：

命令行参数
环境变量
配置文件
默认值

故障排除

常见问题及解决方案

问题	解决方案
下载速度慢	使用 hf-mirror 镜像或代理
下载中断	使用 `--resume-download` 参数
认证失败	重新运行 `hf login` 或检查令牌权限
上传失败	检查网络连接和存储空间

查看详细日志

使用 --debug 参数查看详细日志，帮助诊断问题：

hf download username/model-name --debug

总结

hf 命令是 Hugging Face 生态系统中不可或缺的工具，它简化了与 Hugging Face Hub 的交互过程。通过本文介绍的方法，您可以：

熟练使用 hf 命令的各种功能
通过 hf-mirror 镜像显著加速下载速度
使用 hf-transfer 工具进一步提升下载性能
应用其他优化措施最大化效率
解决常见的使用问题

特别是结合使用 hf-mirror 镜像和 hf-transfer 工具，可以获得最佳的下载体验，即使在网络条件不佳的情况下也能高效地获取 Hugging Face Hub 上的资源。

无论您是在本地开发还是在服务器上部署模型，掌握这些技巧都能大大提高您的工作效率。

zip、unzip 和 tar 压缩解压实用指南

2025-12-15T00:00:00-08:00

zip、unzip 和 tar 是 Linux 系统中最常用的三个压缩解压工具。zip 和 unzip 专门用于处理 .zip 格式的压缩文件，其中 zip 用于创建压缩包，unzip 用于解压。而 tar 则主要用于打包多个文件和目录，并可以配合压缩算法（如 gzip、bzip2、xz）进行压缩。本文将重点介绍这三个工具的实用操作和常见场景，帮助您在日常工作中高效地处理各种压缩文件。

核心功能

`zip` 工具

zip 是专门用于创建 .zip 格式压缩文件的命令行工具，支持：

压缩单个或多个文件
压缩整个目录
递归压缩子目录
设置压缩级别
添加密码保护
排除特定文件或目录
更新已有压缩包

`unzip` 工具

unzip 是专门用于解压 .zip 格式压缩文件的命令行工具，支持：

解压单个或多个文件
查看压缩包内容而不解压
选择性解压特定文件
处理密码保护的压缩包
覆盖控制和解压到指定目录

`tar` 工具

tar (Tape Archive) 最初用于磁带备份，现在已成为 Linux 系统中标准的打包工具。它可以：

将多个文件和目录打包成一个文件
配合压缩算法（gzip、bzip2、xz）进行压缩
解压和提取打包文件
查看打包文件内容
增量备份和恢复

安装工具

安装 `zip`

# Debian/Ubuntu
sudo apt-get install zip

# CentOS/RHEL
sudo yum install zip

# Fedora
sudo dnf install zip

# Arch Linux
sudo pacman -S zip

安装 `unzip`

# Debian/Ubuntu
sudo apt-get install unzip

# CentOS/RHEL
sudo yum install unzip

# Fedora
sudo dnf install unzip

# Arch Linux
sudo pacman -S unzip

安装 `tar`

大多数 Linux 发行版默认已安装 tar。如果需要安装：

# Debian/Ubuntu
sudo apt-get install tar

# CentOS/RHEL
sudo yum install tar

# Fedora
sudo dnf install tar

# Arch Linux
sudo pacman -S tar

`zip` 基本用法

1. 基本压缩操作

# 压缩单个文件
zip archive.zip file1.txt

# 压缩多个文件
zip archive.zip file1.txt file2.txt file3.txt

# 压缩目录（不包含子目录）
zip archive.zip directory/

# 递归压缩目录（包含所有子目录）
zip -r archive.zip directory/

# 压缩时不显示详细信息
zip -q archive.zip file1.txt

# 压缩时显示详细信息
zip -v archive.zip file1.txt

2. 设置压缩级别

# 最快压缩（压缩率最低）
zip -0 archive.zip file1.txt

# 默认压缩级别
zip -6 archive.zip file1.txt

# 最高压缩率（速度最慢）
zip -9 archive.zip file1.txt

3. 添加密码保护

# 压缩时添加密码
zip -e archive.zip file1.txt
# 系统会提示输入密码

# 直接指定密码（不安全，不推荐）
zip -P password archive.zip file1.txt

4. 排除文件和目录

# 排除特定文件
zip -r archive.zip directory/ -x "*.log"

# 排除多个文件类型
zip -r archive.zip directory/ -x "*.log" "*.tmp" "*.cache"

# 排除特定目录
zip -r archive.zip directory/ -x "node_modules/*" "dist/*"

# 排除隐藏文件
zip -r archive.zip directory/ -x ".*"

5. 更新已有压缩包

# 向已有压缩包添加文件
zip -u archive.zip newfile.txt

# 更新压缩包中的文件
zip -u archive.zip updatedfile.txt

# 刷新压缩包（仅更新已存在的文件）
zip -FS archive.zip directory/

6. 查看压缩包内容

# 列出压缩包中的文件
zip -sf archive.zip

# 详细列出压缩包信息
zip -v archive.zip

# 测试压缩包的完整性
zip -T archive.zip

7. 删除压缩包中的文件

# 从压缩包中删除文件
zip -d archive.zip file1.txt

# 从压缩包中删除多个文件
zip -d archive.zip file1.txt file2.txt

8. 分卷压缩

# 使用 split 创建分卷压缩（每卷 100MB）
zip -r - archive.zip directory/ | split -d -b 100M - archive.zip.

# 合并分卷压缩文件
cat archive.zip.* > archive.zip

`unzip` 基本用法

1. 基本解压操作

# 解压到当前目录
unzip archive.zip

# 解压到指定目录
unzip archive.zip -d /path/to/destination

# 解压时不显示详细信息
unzip -q archive.zip

# 解压时显示详细信息
unzip -v archive.zip

2. 查看压缩包内容

# 列出压缩包中的文件
unzip -l archive.zip

# 详细列出压缩包信息
unzip -v archive.zip

3. 选择性解压

# 只解压特定文件
unzip archive.zip file1.txt file2.txt

# 解压匹配模式的文件
unzip archive.zip "*.txt"

# 排除特定文件
unzip archive.zip -x "*.log"

4. 覆盖控制

# 覆盖已存在的文件（默认行为）
unzip -o archive.zip

# 不覆盖已存在的文件
unzip -n archive.zip

# 交互式询问是否覆盖
unzip -o -a archive.zip

5. 处理密码保护的压缩包

# 解压密码保护的压缩包
unzip -P password archive.zip

# 解压时提示输入密码（更安全）
unzip archive.zip
# 系统会提示输入密码

`tar` 基本用法

tar 命令的基本语法为：tar [选项] [文件名]

常用选项：

-c: 创建新的打包文件
-x: 解压打包文件
-t: 查看打包文件内容
-v: 显示详细过程
-f: 指定文件名（必须放在选项最后）
-z: 使用 gzip 压缩/解压
-j: 使用 bzip2 压缩/解压
-J: 使用 xz 压缩/解压
-C: 切换到指定目录

1. 打包操作

# 打包多个文件
tar -cvf archive.tar file1.txt file2.txt

# 打包整个目录
tar -cvf archive.tar /path/to/directory

# 打配 gzip 压缩（.tar.gz 或 .tgz）
tar -czvf archive.tar.gz /path/to/directory

# 打配 bzip2 压缩（.tar.bz2）
tar -cjvf archive.tar.bz2 /path/to/directory

# 打配 xz 压缩（.tar.xz）
tar -cJvf archive.tar.xz /path/to/directory

2. 解压操作

# 解压 .tar 文件
tar -xvf archive.tar

# 解压 .tar.gz 文件
tar -xzvf archive.tar.gz

# 解压 .tar.bz2 文件
tar -xjvf archive.tar.bz2

# 解压 .tar.xz 文件
tar -xJvf archive.tar.xz

# 解压到指定目录
tar -xvf archive.tar -C /path/to/destination

3. 查看打包文件内容

# 查看 .tar 文件内容
tar -tvf archive.tar

# 查看 .tar.gz 文件内容
tar -tzvf archive.tar.gz

# 查看文件列表（不显示详细信息）
tar -tf archive.tar

4. 增量操作

# 向已有打包文件中添加文件
tar -rvf archive.tar newfile.txt

# 更新打包文件中的文件（如果文件较新）
tar -uvf archive.tar updatedfile.txt

# 从打包文件中删除文件
tar --delete -f archive.tar file.txt

常用场景示例

场景 1: 下载并解压软件包

# 下载软件包
wget https://example.com/software.tar.gz

# 解压到指定目录
tar -xzvf software.tar.gz -C /opt/

# 或者解压到当前目录
tar -xzvf software.tar.gz

场景 2: 创建项目压缩包

# 压缩项目目录，排除不必要的文件
zip -r project_$(date +%Y%m%d).zip project/ -x "node_modules/*" "dist/*" ".git/*" "*.log"

# 创建带密码的项目备份
zip -e -r project_backup.zip project/

# 创建分卷压缩包（每卷 500MB）
zip -r - project.zip project/ | split -d -b 500M - project.zip.

场景 3: 备份项目目录

# 创建带日期的备份
tar -czvf backup_$(date +%Y%m%d).tar.gz /path/to/project

# 排除某些文件或目录
tar -czvf backup.tar.gz /path/to/project --exclude="*.log" --exclude="node_modules"

# 排除多个目录
tar -czvf backup.tar.gz /path/to/project --exclude={node_modules,dist,*.log}

场景 4: 解压 Windows 传输的 zip 文件

# 解压 zip 文件
unzip windows_files.zip -d ./extracted

# 处理文件名编码问题（中文文件名）
unzip -O GBK windows_files.zip -d ./extracted

# 查看压缩包内容
unzip -l windows_files.zip

场景 5: 批量解压多个压缩文件

# 解压所有 .zip 文件
for file in *.zip; do unzip "$file" -d "${file%.zip}"; done

# 解压所有 .tar.gz 文件
for file in *.tar.gz; do tar -xzvf "$file"; done

# 使用 find 命令递归解压
find . -name "*.tar.gz" -exec tar -xzvf {} \;

场景 6: 创建分卷压缩文件

# 使用 split 创建分卷压缩
tar -czvf - /path/to/large/directory | split -d -b 100M - archive.tar.gz.

# 合并分卷压缩文件
cat archive.tar.gz.* | tar -xzvf -

高级技巧

1. 使用管道进行实时压缩

# 将命令输出直接打包压缩
ls -l | tar -czvf output.tar.gz -T -

# 备份数据库
mysqldump -u root -p database_name | gzip > backup.sql.gz

# 解压并直接处理
tar -xOzf archive.tar.gz file.txt | grep "pattern"

2. 压缩时排除特定文件

# 排除单个文件
tar -czvf archive.tar.gz /path/to/dir --exclude="file.txt"

# 排除多个文件
tar -czvf archive.tar.gz /path/to/dir --exclude="*.log" --exclude="*.tmp"

# 排除目录
tar -czvf archive.tar.gz /path/to/dir --exclude="node_modules"

# 使用排除文件
echo "*.log" > exclude.txt
echo "node_modules" >> exclude.txt
tar -czvf archive.tar.gz /path/to/dir -X exclude.txt

3. 查看压缩文件大小

# 查看 tar 文件大小
ls -lh archive.tar.gz

# 查看 tar 文件中各文件的大小
tar -tvf archive.tar.gz | awk '{print $3, $6}'

# 计算压缩率
original_size=$(du -sb /path/to/dir | cut -f1)
compressed_size=$(stat -f%z archive.tar.gz)
echo "压缩率: $(echo "scale=2; $compressed_size * 100 / $original_size" | bc)%"

4. 验证压缩文件的完整性

# 验证 tar 文件
tar -tzvf archive.tar.gz > /dev/null && echo "文件完整" || echo "文件损坏"

# 验证 zip 文件
unzip -t archive.zip

# 使用 md5sum 验证
md5sum archive.tar.gz > checksum.md5
md5sum -c checksum.md5

5. 解压时保留权限和时间戳

# tar 默认保留权限和时间戳
tar -xvpf archive.tar

# unzip 保留权限和时间戳
unzip -o archive.zip

# 解压时设置特定权限
tar -xvpf archive.tar --mode=755

常见问题及解决方案

问题	解决方案
解压时文件名乱码	使用 `unzip -O GBK` 或 `unzip -O UTF-8`
磁盘空间不足	使用 `-C` 参数解压到其他分区，或使用管道直接处理
压缩文件损坏	尝试使用 `tar -xvf` 的 `--ignore-failed-read` 参数
解压速度慢	使用 `pigz` 替代 gzip 进行并行压缩解压
文件权限丢失	使用 `tar -p` 参数保留权限

性能优化

1. 使用并行压缩工具

# 安装 pigz（并行 gzip）
sudo apt-get install pigz

# 使用 pigz 压缩（速度更快）
tar -cvf - /path/to/dir | pigz -p 4 > archive.tar.gz

# 使用 pigz 解压
pigz -d -p 4 archive.tar.gz | tar -xvf -

2. 选择合适的压缩算法

# gzip：速度最快，压缩率中等
tar -czvf archive.tar.gz /path/to/dir

# bzip2：压缩率较高，速度较慢
tar -cjvf archive.tar.bz2 /path/to/dir

# xz：压缩率最高，速度最慢
tar -cJvf archive.tar.xz /path/to/dir

3. 调整压缩级别

# gzip 压缩级别（1-9，1最快，9压缩率最高）
tar -czvf -1 archive.tar.gz /path/to/dir  # 最快
tar -czvf -9 archive.tar.gz /path/to/dir  # 最高压缩率

# bzip2 压缩级别（1-9）
tar -cjvf -1 archive.tar.bz2 /path/to/dir

# xz 压缩级别（0-9）
tar -cJvf -0 archive.tar.xz /path/to/dir

总结

zip、unzip 和 tar 是 Linux 系统中不可或缺的压缩解压工具。通过本文介绍的方法，您可以：

熟练使用 zip 创建各种 .zip 压缩文件
熟练使用 unzip 处理各种 .zip 压缩文件
掌握 tar 的打包和压缩操作
根据不同场景选择合适的压缩算法
使用高级技巧提高工作效率
解决常见的压缩解压问题

掌握这些工具的使用技巧，将大大提高您在 Linux 系统中处理文件和目录的效率。无论是日常开发、系统管理还是数据备份，这些工具都能为您提供强大的支持。

建议在实际工作中多加练习，根据具体需求选择最合适的压缩方式和参数，以达到最佳的性能和效果。

关于Tmux的常用操作

2024-05-01T00:00:00-07:00

tmux (Terminal Multiplexer) 是一个强大的终端复用器。它允许用户在单个终端窗口中创建、管理和切换多个独立的会话（Session）、窗口（Window）和面板（Pane）。tmux 的核心优势在于其会话持久化能力，即使终端关闭或网络断开，您在 tmux 中运行的任务也能继续在后台执行，随时可以重新连接并恢复工作。这对于远程开发、长时间运行任务以及提升终端工作效率至关重要。

核心概念

在使用 tmux 之前，理解以下三个核心概念至关重要：

会话 (Session):
- tmux 的最高层级。
- 每个会话都是一个独立的工作空间，可以包含多个窗口。
- 可以有多个会话同时运行。
窗口 (Window):
- 每个会话可以包含多个窗口。
- 每个窗口都相当于一个独立的终端标签页。
面板 (Pane):
- 每个窗口可以进一步分割成多个面板。
- 每个面板都运行一个独立的 shell。
- 类似于在同一个终端窗口中分屏。

`tmux` 工作流程

典型的 tmux 工作流程包括以下步骤：

启动 tmux 会话: 进入 tmux 环境。
在会话中工作: 创建窗口、分割面板，运行命令。
分离会话 (Detach): 暂时离开 tmux 环境，但会话仍在后台运行。
重新连接会话 (Attach): 重新进入之前分离的 tmux 会话，恢复工作。

`tmux` 基本指令

tmux 的所有操作都通过一个前缀键 (Prefix Key) 加上一个命令键来完成。 默认前缀键: Ctrl + b。这意味着：您需要先按下 Ctrl + b，然后松开，再按下后续的命令键。

一、会话 (Session) 管理

指令	作用	备注
`tmux`	启动一个新的 `tmux` 会话。如果当前没有会话，则创建一个并连接。	最简单的启动方式。
`tmux new -s [会话名称]`	启动一个带名称的新会话。例如：`tmux new -s my_project`。	`-s` 指定会话名称。
`tmux ls`	列出所有当前的 `tmux` 会话。	`tmux list-sessions` 的简写。
`tmux attach -t [会话名称]`	重新连接到指定名称的会话。例如：`tmux attach -t my_project`。	`-t` 指定目标会话。如果只有一个会话，直接 `tmux attach` 即可。
`Prefix + d`	分离 (Detach) 当前的 `tmux` 会话。会话在后台继续运行。	最常用操作之一，用于退出 `tmux` 环境而不终止会话。
`tmux kill-session -t [会话名称]`	杀死（结束）指定名称的会话。	请谨慎使用，会话中的所有进程都会被终止。
`tmux kill-server`	杀死所有 `tmux` 会话和服务器。	极少使用，除非您需要彻底清理 `tmux` 环境。

二、窗口 (Window) 管理 (前缀键 `Ctrl + b` + 命令键)

指令	作用	备注
`Prefix + c`	创建一个新的窗口。	新窗口会显示一个新的 shell。
`Prefix + n`	切换到下一个窗口。	`n` for next。
`Prefix + p`	切换到上一个窗口。	`p` for previous。
`Prefix + <数字键>`	切换到指定编号的窗口（例如 `Prefix + 0` 切换到第一个窗口）。	窗口编号从 0 开始。
`Prefix + ,`	重命名当前窗口。	底部状态栏会提示您输入新名称。
`Prefix + w`	选择窗口。会弹出一个交互式列表，显示所有会话和窗口。	`w` for window。您可以使用方向键选择，回车确认。
`Prefix + &`	关闭当前窗口。	会提示确认，`y` 确认，`n` 取消。

三、其他常用指令 (前缀键 `Ctrl + b` + 命令键)

指令	作用	备注
`Prefix + [`	进入复制模式。允许您向上滚动查看历史输出，并复制文本。	进入后，可以使用方向键滚动，`Space` 开始选择，`Enter` 复制。
`Prefix + ]`	粘贴 `tmux` 内部剪贴板中的内容。
`Prefix + ?`	显示所有 `tmux` 快捷键的帮助信息。
`Prefix + t`	显示一个大时钟。

常用场景示例

长时间运行任务:
- tmux new -s my_build (启动会话)
- 运行 npm install 或 git clone 等耗时操作。
- Ctrl + b + d (分离会话)
- 关闭终端或断开 SSH 连接。
- 稍后回来，tmux attach -t my_build 即可查看任务进度。
分屏工作:
- tmux (启动会话)
- Ctrl + b + " (垂直分割面板)
- Ctrl + b + % (水平分割面板)
- Ctrl + b + 方向键 (在不同面板间切换)
- 一个面板运行代码编辑器，一个面板运行服务器，一个面板查看日志。
多项目管理:
- tmux new -s project_alpha
- 在 project_alpha 中工作。
- Ctrl + b + d (分离 project_alpha)
- tmux new -s project_beta
- 在 project_beta 中工作。
- Ctrl + b + d (分离 project_beta)
- tmux ls (查看所有会话)
- tmux attach -t project_alpha (重新连接到 project_alpha)

`tmux` 配置 (`~/.tmux.conf`)

tmux 可以通过编辑用户主目录下的配置文件 ~/.tmux.conf 进行高度定制，以适应个人工作习惯。常见的定制包括：

更改前缀键: 许多用户将前缀键从默认的 Ctrl + b 改为 Ctrl + a。
```
# ~/.tmux.conf
unbind C-b
set-option -g prefix C-a
bind-key C-a send-prefix
```
启用鼠标支持: 允许使用鼠标点击切换面板、调整大小、滚动。
```
# ~/.tmux.conf
set -g mouse on
```
状态栏美化: 自定义底部状态栏显示的信息和颜色，使其更具信息量和个性化。

示例

图中，[2]表示会话编号或会话名称。0:bash,1:2,2:666表示存在三个窗口，窗口编号分别为0,1,2;窗口名称分别为bash,2,666。*表示当前所处的为窗口0。

Henry Zhu / Site Title

Git常用命令实用指南

核心概念

Git 基本指令

一、初始化与配置

二、基本操作

三、分支管理

四、远程操作

五、撤销与恢复

六、查看与比较

常用场景示例

场景 1: 开始新项目

场景 2: 开发新功能

场景 3: 修复错误

场景 4: 协作开发

Git 配置优化

1. 设置别名

2. 设置默认分支名

3. 配置编辑器

4. 配置差异工具

高级技巧

1. 交互式暂存

2. 储藏 (Stash)

3. 变基 (Rebase)

4. 挑选 (Cherry-pick)

5. 标签 (Tag)

常见问题解决

1. 合并冲突

2. 撤销已推送的提交

3. 忘记添加文件到提交

4. 查看文件历史

总结

Hugging Face CLI (hf命令) 实用指南

核心功能

安装 hf 命令

从 PyPI 安装

基本认证

hf 命令基本用法

1. 模型和数据集管理

下载模型

上传模型

列出模型

2. 空间管理

创建空间

部署到空间

3. 配置管理

查看配置

设置配置

使用 hf-mirror 镜像加速

临时使用镜像

永久设置镜像

其他加速措施

1. 配置缓存目录

2. 使用 --resume-download 参数

3. 批量下载优化

4. 并行下载

5. 使用系统代理

6. 使用 hf-transfer 加速

安装 hf-transfer

启用 hf-transfer

永久启用 hf-transfer

与镜像结合使用

常用场景示例

场景 1: 快速下载大模型

场景 2: 上传本地模型到 Hub

场景 3: 批量下载数据集

高级配置

配置文件结构

环境变量优先级

故障排除

常见问题及解决方案

查看详细日志

总结

zip、unzip 和 tar 压缩解压实用指南

核心功能

zip 工具

unzip 工具

tar 工具

安装工具

安装 zip

安装 `hf` 命令

`hf` 命令基本用法

2. 使用 `--resume-download` 参数

`zip` 工具

`unzip` 工具

`tar` 工具

安装 `zip`

安装 `unzip`

安装 `tar`

`zip` 基本用法

`unzip` 基本用法

`tar` 基本用法

`tmux` 工作流程

`tmux` 基本指令

二、窗口 (Window) 管理 (前缀键 `Ctrl + b` + 命令键)

三、其他常用指令 (前缀键 `Ctrl + b` + 命令键)

`tmux` 配置 (`~/.tmux.conf`)