DJuR

Git 使用与配置全指南

Fri, 06 Feb 2026 00:00:00 +0000

Git 使用与配置全指南

本文记录 Git 常用配置、项目级与全局配置、代理设置、缓存清理、多账户管理以及基本 rebase 使用。

1. Git 配置概览

Git 配置用于定义 Git 行为和操作习惯，可以影响 commit、push、pull 等操作。主要配置文件：

配置等级	配置文件位置	作用范围
系统级	`/etc/gitconfig` (Linux/Mac) `C:\ProgramData\Git\config` (Windows)	对系统所有用户生效
全局级	`~/.gitconfig` 或 `~/.config/git/config`	对当前用户生效
仓库级	`.git/config`	对当前 Git 仓库生效

配置优先级：仓库级 > 用户级 > 系统级

2. Git 配置等级

系统级配置

git config --system user.name "SystemUser"
git config --system user.email "system@example.com"

系统级配置需要管理员权限。

用户/全局配置

git config --global user.name "YourName"
git config --global user.email "you@example.com"

仓库级配置

cd /path/to/your/repo
git config user.name "ProjectUser"
git config user.email "project@example.com"

仓库级配置会覆盖全局配置。

3. 查看当前配置

# 查看全部配置
git config --list

# 查看特定配置
git config user.name
git config --get user.email

# 查看各级别配置
git config --system --list
git config --global --list
git config --local --list

# 查看配置来源
git config -l --show-origin

4. 用户信息配置

git config --global user.name "DJUR"
git config --global user.email "djur@example.com"

验证：

git config --global --list
# 输出：
# user.name=DJUR
# user.email=djur@example.com

5. 代理配置

HTTP / HTTPS 代理

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

SOCKS5 代理

git config --global http.proxy 'socks5://127.0.0.1:1080'
git config --global https.proxy 'socks5://127.0.0.1:1080'

取消代理

git config --global --unset http.proxy
git config --global --unset https.proxy

6. 常用 Git 配置项

# 编辑器
git config --global core.editor "code --wait"

# 差异显示颜色
git config --global color.ui auto

# 默认分支名
git config --global init.defaultBranch main

# 合并冲突显示方式
git config --global merge.conflictstyle diff3

# 缓存 HTTPS 凭证
git config --global credential.helper cache --timeout=3600

# 拉取策略
git config --global pull.rebase false      # merge 默认
git config --global pull.ff only           # 快进

7. 配置文件说明

[user]
    name = DJUR
    email = djur@example.com
[core]
    editor = code --wait
    autocrlf = input
[color]
    ui = auto
[http]
    proxy = http://127.0.0.1:7890
[credential]
    helper = cache --timeout=3600
[init]
    defaultBranch = main

8. Git 缓存管理

移除已缓存的文件 / 清理缓存

# 移除已缓存但未提交的文件
git rm --cached <file>

# 移除所有缓存文件（例如 .gitignore 生效）
git rm -r --cached .
git add .
git commit -m "Apply .gitignore"

清理凭证缓存

git credential-cache exit

9. 多账户 SSH / HTTPS 切换

1. SSH 多账户配置

编辑 ~/.ssh/config：

# GitHub 个人账号
Host github-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_personal

# GitHub 工作账号
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_work

克隆仓库时使用别名：

git clone git@github-personal:username/repo.git
git clone git@github-work:company/repo.git

2. HTTPS 多账户（凭证缓存）

# 针对仓库设置不同用户
git config user.name "WorkUser"
git config user.email "work@example.com"

# 使用 credential helper 保存不同账户密码
git config credential.helper store

10. 基本 rebase 使用与作用

rebase 用于将分支修改“移动”到另一分支的最前端，保持提交历史线性。

1. 交互式 rebase

# 修改最近 3 次提交
git rebase -i HEAD~3

可用于合并提交、修改提交信息、删除提交。

2. 将分支更新到主分支

# 切到 feature 分支
git checkout feature

# 将 main 分支的最新提交移动到 feature 前端
git rebase main

3. 使用注意事项

已推送到远程的分支尽量不要 rebase，会破坏公共历史
rebase 后若出现冲突，手动解决冲突并执行：
```
git rebase --continue
```
放弃 rebase：
```
git rebase --abort
```

11. 实战技巧

多账户管理
- 仓库级配置 + SSH 配置，实现个人/工作账号切换。
代理自动切换
- 脚本检测网络环境，自动配置代理。
配置优先级检查
- git config -l --show-origin 查看每条配置来源。
缓存与 .gitignore 生效
- git rm -r --cached . 配合 .gitignore 清理无效文件。
保持提交历史整洁
- 使用 rebase 合并小提交，保证线性历史。

掌握 Git 配置、代理、多账户管理及 rebase 技巧，可以让开发者在多环境、多项目中高效协作，避免常见的冲突和身份混乱问题。

如果你愿意，我可以帮你加一段 “一键初始化新项目 Git 高级配置脚本”，让你新建项目时自动应用全局、仓库级配置、代理、多账户 SSH、默认分支和基本 rebase 策略，一行命令就能搞定，非常适合技术博客附带示例。

你希望我加吗？

跨平台环境变量管理工具 - 让环境配置更简单

Thu, 05 Feb 2026 00:00:00 +0000

跨平台环境变量管理工具 - 让环境配置更简单

跨平台环境变量管理工具 - 让环境配置更简单

在开发工作中，我们经常需要在不同的环境之间切换配置 - 比如开发环境、测试环境、生产环境，或者切换不同的 API 服务商。每次都要手动修改环境变量？太麻烦了！

今天介绍一款我开发的环境变量管理工具，它可以帮助你轻松管理多个环境配置，支持一键切换，而且完全跨平台。

✨ 为什么需要这个工具？

典型场景

想象一下这些场景：

多 API 服务商切换
- 开发时用 OpenAI GPT-4
- 测试时用阿里云 Qwen
- 生产环境用 Anthropic Claude
- 每次都要改代码、改配置？
多环境配置
- 本地开发环境
- 测试环境
- 生产环境
- 如何快速切换？
团队协作
- 每个人有自己的 API 密钥
- 如何安全共享配置模板？
不同 Shell/平台
- Windows 的 CMD/PowerShell
- Linux 的 Bash/Zsh
- macOS 的 Zsh
- 每个平台写不同脚本？

这款工具就是为了解决这些问题而生的！

🎯 核心功能一览

功能	说明
🖥️ 全平台支持	Windows、Linux、macOS 一把梭
🔧 多配置管理	定义任意数量的环境配置
⚡ 一键切换	一个命令完成切换
🔒 配置加密	AES-256 保护敏感信息
📝 .env 支持	兼容主流 .env 格式
💾 永久设置	写入系统环境变量
📦 可执行打包	无需安装 Python

🚀 快速开始

下载使用

项目支持两种使用方式：

方式一：使用可执行文件（推荐）

无需安装 Python，直接运行：

# Linux/macOS
chmod +x env-manager
./env-manager --list

# Windows
env-manager.exe --list

方式二：使用 Python 脚本

# 需要安装 Python 3.8+
python env-manager.py --list

初始化配置

首次使用需要创建配置文件：

# 方式一：复制模板
cp config.json.example config.json

# 方式二：自动初始化
env-manager --init

编辑 config.json，填入你的实际配置：

{
  "openai": {
    "OPENAI_API_KEY": "sk-your-key-here",
    "OPENAI_BASE_URL": "https://api.openai.com/v1",
    "MODEL": "gpt-4"
  },
  "anthropic": {
    "ANTHROPIC_API_KEY": "sk-ant-your-key-here",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "MODEL": "claude-3-opus"
  }
}

📖 常用命令

查看和管理配置

# 列出所有配置
env-manager --list

# 查看某个配置详情
env-manager openai --print

# 验证配置是否完整
env-manager openai --validate

# 查看应用和配置文件信息
env-manager --info

加载配置到当前会话

# Linux/macOS - 导出环境变量
source <(env-manager openai --export)

# Windows CMD
env-manager.bat openai

# Windows PowerShell
.\env-manager.ps1 openai

永久设置环境变量

设置后重启终端依然生效：

# 用户级别
env-manager openai --permanent

# 系统级别（需要管理员/sudo）
sudo env-manager openai --permanent --scope system

配置加密

保护你的敏感信息：

# 加密配置文件
env-manager --encrypt

# 解密配置文件
env-manager --decrypt

# 编辑加密配置
env-manager --edit-encrypted

.env 文件支持

# 导出为 .env 文件
env-manager openai --to-dotenv

# 从 .env 文件导入
env-manager --from-dotenv .env new-config

🔐 安全最佳实践

1. 不要提交敏感配置

使用 .gitignore 忽略配置文件：

# 配置文件
config.json
local_config.json
config.enc

# 敏感信息
*.key
*.secret

2. 使用加密存储

# 加密配置后再提交
env-manager --encrypt
git add config.enc
git commit -m "Update encrypted config"

3. 本地配置覆盖

创建 local_config.json 存储本地专用配置，不会被提交：

{
  "my-local-dev": {
    "API_KEY": "local-dev-only-key",
    "DEBUG": "true",
    "HOST": "localhost:8080"
  }
}

💡 实战技巧

技巧一：创建快捷命令

在 ~/.bashrc 或 ~/.zshrc 中添加：

# Linux/macOS
alias env-use='source <(env-manager $1 --export)'

# 使用方式
env-use openai
env-use anthropic

技巧二：多环境管理

{
  "dev": {
    "API_BASE": "https://dev.api.example.com",
    "DEBUG": "true"
  },
  "staging": {
    "API_BASE": "https://staging.api.example.com",
    "DEBUG": "false"
  },
  "prod": {
    "API_BASE": "https://api.example.com",
    "DEBUG": "false"
  }
}

技巧三：团队协作流程

提交配置模板 config.json.example
团队成员复制并修改为 config.json
.gitignore 忽略实际配置文件
敏感配置使用 --encrypt 加密

技巧四：Docker 集成

FROM python:3.9-slim

COPY env-manager /usr/local/bin/
COPY config.enc /app/

# 解密配置并运行
CMD sh -c "echo $PASSWORD | env-manager --decrypt && \
           env-manager prod --set && \
           python app.py"

📦 打包和分发

想分发给团队使用？打包成可执行文件：

# 1. 安装打包依赖
pip install -r requirements.txt

# 2. 执行打包
python build.py

# 3. 分发 dist/ 目录

打包后用户无需安装 Python，直接运行即可！

🛠️ 故障排除

问题：找不到配置文件

# 查看配置文件位置
env-manager --info

# 或重新初始化
env-manager --init

问题：权限不足

# Linux/macOS
chmod +x env-manager

# Windows 永久设置需要管理员权限

问题：macOS 提示应用已损坏

# 移除隔离属性
xattr -d com.apple.quarantine env-manager

📚 总结

这个环境变量管理工具解决了开发中常见的配置管理痛点：

✅ 简单 - 一个命令完成切换 ✅ 安全 - 支持加密存储敏感信息 ✅ 跨平台 - Windows/Linux/macOS 统一使用 ✅ 灵活 - 支持多种配置格式 ✅ 便携 - 可打包为独立可执行文件

希望这个工具能提高你的开发效率！如有问题或建议，欢迎提 Issue。

下载地址： GitHub 仓库链接

版本：3.0.0 许可证：MIT

如果你觉得这个工具有用，欢迎 Star ⭐

Markdown 语法

Sat, 06 Jan 2018 00:00:00 +0000

Markdown 语法
常用语法
example:
符号
扩展阅读

Markdown 语法

Markdown是一个用于web编写器将文本转换成标记语言的工具(text-to-HTML)。Markdown允许使用易于读、易于写的纯文本格式编写，然后转换成标准结构的XHTML（或HTML）.

Markdown做的两件事: (1) 纯文本格式语法。 (2) 用Perl编写的工具，将纯文本转换成HTML。

常用语法

haroopad 编辑器中快捷键

名称	Markdown	效果	快捷键
标题	`=`,`-`,`#`	H*
加粗	`text`	text	`Ctrl+B`
斜体	`text`	text	`Ctrl+I`
删除线	`~~text~~`	~~text~~	`Ctrl+U`
链接	`[title](http://)`	title	`Ctrl+L`
图片	`![alt](http://)`
代码	` `code` `	`code`	`Ctrl+K`
列表	`* quoteitem`,`+ quoteitem`,`- quoteitem`
引用	` > quote `

example:

标题

标题一
=====

标题二
------

# 标题* #[1-6]

列表

+ 列表一
- 列表二
* 列表三
1. 数字列表

引用

> ## This is a header.
> 
> 1.   This is the first list item.
> 2.   This is the second list item.
> 
> Here's some example code:
> 
>     return shell_exec("echo $input | $markdown_script");

符号

Markdown	效果
`©`	©
`AT&`	AT&T
`4<5`	4<5

扩展阅读

markdown 语法 markdown中文