194 lines
4.7 KiB
Markdown
194 lines
4.7 KiB
Markdown
# luochen570/dotfiles
|
||
|
||
个人 Linux/WSL 环境配置，集成 **ZSH** + **Neovim (NvChad)**。
|
||
|
||
## 总览
|
||
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| Shell | ZSH + zinit + Powerlevel10k |
|
||
| 编辑器 | Neovim + NvChad v2.5 + lazy.nvim |
|
||
| 系统 | WSL / Debian / Ubuntu |
|
||
|
||
---
|
||
|
||
## 安装
|
||
|
||
### 1. 克隆仓库
|
||
|
||
```bash
|
||
git clone git@github.com:luochen570/dotfiles.git ~/dotfiles
|
||
cd ~/dotfiles
|
||
```
|
||
|
||
### 2. 安装必要包
|
||
|
||
```bash
|
||
# Debian / Ubuntu
|
||
sudo apt install -y \
|
||
zsh git curl wget \
|
||
eza tree bat \
|
||
unzip ripgrep fd-find \
|
||
fzf command-not-found
|
||
|
||
# yazi（终端文件管理器）
|
||
# curl -sL https://github.com/sxyazi/yazi/releases/latest/download/yazi-x86_64-unknown-linux-gnu.zip
|
||
# 或使用包管理器 / cargo
|
||
# cargo install yazi-fm
|
||
|
||
# uv（Python 包管理器）
|
||
curl -LsSf https://astral.sh/uv/install.sh | sh
|
||
```
|
||
|
||
### 3. 安装 ZSH
|
||
|
||
```bash
|
||
# 设置 ZSH 为默认 shell
|
||
chsh -s $(which zsh)
|
||
|
||
# 安装 zinit（如未自动安装）
|
||
ZINIT_HOME="${XDG_DATA_HOME:-${HOME}/.local/share}/zinit/zinit.git"
|
||
mkdir -p "$(dirname "$ZINIT_HOME")"
|
||
git clone https://github.com/zdharma-continuum/zinit.git "$ZINIT_HOME"
|
||
```
|
||
|
||
### 4. 部署配置
|
||
|
||
```bash
|
||
# ZSH 配置
|
||
ln -sf ~/dotfiles/.zshrc ~/.zshrc
|
||
|
||
# Neovim 配置（NvChad）
|
||
ln -sf ~/dotfiles/nvim ~/.config/nvim
|
||
|
||
# Powerlevel10k 配置（可选）
|
||
ln -sf ~/dotfiles/.p10k.zsh ~/.p10k.zsh
|
||
```
|
||
|
||
### 5. 安装 Neovim 插件
|
||
|
||
启动 Neovim 后自动安装：
|
||
|
||
```bash
|
||
nvim
|
||
```
|
||
|
||
等待 lazy.nvim 下载完成即可。
|
||
|
||
---
|
||
|
||
## ZSH 配置
|
||
|
||
### 主题：Powerlevel10k
|
||
|
||
使用 [Powerlevel10k](https://github.com/romkatv/powerlevel10k) 作为 ZSH 主题，提供丰富的提示信息：
|
||
|
||
- Git 状态（分支、修改、未跟踪）
|
||
- 命令执行时间
|
||
- 当前目录
|
||
- 后台作业
|
||
- 错误码状态
|
||
|
||
首次启动会进入交互式配置向导，按喜好选择样式即可。
|
||
|
||
### 插件管理器：zinit
|
||
|
||
使用 [zinit](https://github.com/zdharma-continuum/zinit) 作为插件管理器，支持异步加载，启动速度快。
|
||
|
||
### 加载的插件
|
||
|
||
| 插件 | 说明 | 加载方式 |
|
||
|------|------|---------|
|
||
| **OMZL::git** | Git 补全与函数 | 同步 |
|
||
| **OMZL::history** | 历史记录设置 | 同步 |
|
||
| **OMZL::key-bindings** | 按键绑定 | 延迟 1s |
|
||
| **OMZL::completion** | 补全系统 | 延迟 1s |
|
||
| **command-not-found** | 命令缺失提示 | 延迟 0s |
|
||
| **colored-man-pages** | man 页彩色高亮 | 延迟 3s |
|
||
| **fast-syntax-highlighting** | 命令行语法高亮 | 异步 |
|
||
| **zsh-autosuggestions** | 历史命令建议 | 异步 |
|
||
| **sudo** | 双击 ESC 加 sudo | 延迟 2s |
|
||
| **z** | 目录频率跳转 | 延迟 1s |
|
||
| **git** | Git 别名与函数 | 延迟 1s |
|
||
| **extract** | 一键解压 | 延迟 1s |
|
||
| **kubectl** | Kubernetes 补全 | 延迟 2s |
|
||
| **helm** | Helm 补全 | 延迟 2s |
|
||
|
||
### 别名
|
||
|
||
| 命令 | 说明 |
|
||
|------|------|
|
||
| `ls` | eza（现代 ls，带颜色/图标） |
|
||
| `l` / `la` / `ll` / `lt` | eza 各种格式输出 |
|
||
| `lst` | 树形目录（eza tree 或 tree） |
|
||
| `...` / `....` | cd ../.. / cd ../../.. |
|
||
| `1` ~ `9` | cd -1 ~ cd -9（目录历史快速跳转） |
|
||
| `_` | sudo（空格加命令） |
|
||
| `gc1` | git clone --recursive --depth=1 |
|
||
| `md` | mkdir -p |
|
||
| `rd` | rmdir |
|
||
| `proxy-on` / `proxy-off` | HTTP 代理开关（127.0.0.1:7890） |
|
||
| `y` | yazi 文件管理器并自动 cd 到退出目录 |
|
||
| `uv` | Python 包管理器（含自动补全） |
|
||
|
||
---
|
||
|
||
## Neovim 配置
|
||
|
||
使用 [NvChad v2.5](https://github.com/NvChad/NvChad) 作为基础，通过 lazy.nvim 管理插件。
|
||
|
||
### 结构
|
||
|
||
```
|
||
nvim/
|
||
├── init.lua # 入口
|
||
├── lua/
|
||
│ ├── chadrc.lua # NvChad 配置覆盖
|
||
│ ├── mappings.lua # 自定义快捷键
|
||
│ ├── options.lua # 编辑器选项
|
||
│ ├── autocmds.lua # 自动命令
|
||
│ ├── plugins/
|
||
│ │ └── init.lua # 额外插件
|
||
│ └── configs/
|
||
│ ├── lazy.lua # lazy.nvim 配置
|
||
│ ├── lspconfig.lua # LSP 配置
|
||
│ └── conform.lua # 格式化配置
|
||
└── lazy-lock.json # 插件版本锁
|
||
```
|
||
|
||
### 快捷键
|
||
|
||
| 按键 | 说明 |
|
||
|------|------|
|
||
| `<Space>` | Leader 键 |
|
||
| `<Space>ff` | 查找文件 (Telescope) |
|
||
| `<Space>fg` | 查找文本 (Telescope) |
|
||
| `<Space>fb` | 查找缓冲区 (Telescope) |
|
||
| `<Space>e` | 文件树 (NvimTree) |
|
||
| `K` | 查看 LSP 文档 |
|
||
| `gd` | 跳转到定义 |
|
||
| `gr` | 查找引用 |
|
||
|
||
### 已配置的语言支持
|
||
|
||
开箱即用的 LSP + 格式化：
|
||
|
||
- Lua（lua_ls + stylua）
|
||
- Go（gopls + gofmt）
|
||
- Python（pyright + black）
|
||
- TypeScript / JavaScript（ts_ls + prettier）
|
||
- Rust（rust_analyzer）
|
||
- YAML / JSON / Markdown
|
||
|
||
---
|
||
|
||
## 国内加速
|
||
|
||
如需在中国大陆使用，zinit 和 Neovim 插件管理器会自动使用 GitHub 代理镜像加速。
|
||
|
||
---
|
||
|
||
## 许可证
|
||
|
||
MIT
|