# dotfiles

**Repository Path**: openbit/dotfiles

## Basic Information

- **Project Name**: dotfiles
- **Description**: 适用于linux的"点"（dotfiles）配置文件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-30
- **Last Updated**: 2026-01-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 使用 stow 管理 dotfiles

简短说明、约定与常用命令，方便用 GNU stow 在家目录创建/撤销符号链接管理 dotfiles。

## 前置
- 安装 stow（示例）
    - Debian/Ubuntu: `sudo apt install stow`
    - macOS (Homebrew): `brew install stow`
    - Windows (MSYS2/Chocolatey/WSL): 使用对应包管理器

## 目录结构（示例）
```
~/dotfiles/
├── bash/
│   └── .bashrc
├── nvim/
│   └── .config/nvim/init.vim
├── git/
│   └── .gitconfig
```
每个子目录视为一个 package（要被 stow 管理的一组文件）。

## 常用命令
- 在 dotfiles 根目录运行（推荐）：
    - 切换到 dotfiles 目录： `cd ~/dotfiles`
    - 安装 package（创建到 $HOME 的符号链接）：
        `stow -v bash git nvim`
    - 指定目标目录（例如 $HOME）：  
        `stow --target="$HOME" bash`
    - 撤销（删除符号链接）：  
        `stow -D git`
    - 预演（不实际改变，查看将发生的操作）：  
        `stow -n bash`
    - 重新安装/更新所有 package：  
        `stow -R *`
    - 当本地已有文件想被 stow 接管：  
        `stow --adopt package`

## 常用选项
- `-v` / `--verbose`：显示详细信息  
- `-n` / `--no`：dry-run（仅显示，不执行）  
- `-D` / `--delete`：删除符号链接（撤销）  
- `--target` / `-t`：指定目标目录（默认 HOME）  
- `--dir`：指定 dotfiles 根目录（若不在当前目录）  
- `--ignore`：忽略匹配模式的文件

## 注意与最佳实践
- 先用 `-n` 预演，确认不会覆盖重要文件。  
- 对于会覆盖已有配置的情况，先备份原文件或使用 `--adopt` 小心接管。  
- 每个应用一个 package，便于管理与撤销。  
- 将 dotfiles 仓库纳入版本控制（git），并在 README 记录安装步骤。  
- 在 Windows/WSL/不同系统上使用时，注意路径与换行差异。

## 快速示例
```
cd ~/dotfiles
stow --target="$HOME" -v bash git nvim       # 安装
stow -n --target="$HOME" zsh                # 预览 zsh 安装效果
stow -D --target="$HOME" git                # 卸载 git package
```

## 配置vim主题

##### 创建目录

```bash
mkdir -p ~/.vim/colors
```

##### 下载 Gruvbox 核心文件

```bash
curl -fLo ~/.vim/colors/gruvbox.vim --create-dirs \  https://raw.githubusercontent.com/morhetz/gruvbox/master/colors/gruvbox.vim
```