# vim-nerdtree-install

**Repository Path**: chrvip1/vim-nerdtree-install

## Basic Information

- **Project Name**: vim-nerdtree-install
- **Description**: 离线方式在 vim 中安装 nerdtree 插件，不需要其他任何依赖
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vim NERDTree 离线安装包

适用于银河麒麟 V10 SP3 (x86_64/ARM64) 的 Vim NERDTree 插件一键安装方案。

## 项目简介

本项目提供了完整的 NERDTree 插件离线安装解决方案，包括：
- ✅ NERDTree 7.1.3 插件文件（已包含在安装包中）
- ✅ 统一管理脚本（安装/卸载/状态查询）
- ✅ 自动配置快捷键（Ctrl+n 打开/关闭）
- ✅ 自动启用语法高亮（所有文件类型）
- ✅ 配置自动备份和恢复
- ✅ 支持所有用户使用
- ✅ 可重复执行（幂等性）
- ✅ 完整的使用说明书

## 系统要求

- **操作系统**: 银河麒麟 V10 SP3 或兼容的 Linux 发行版
- **Vim 版本**: 7.3 或更高版本
- **处理器架构**: x86_64, i686, aarch64, armv7l
- **权限**: 安装需要 root 权限

## 快速开始

### 安装

```bash
# 进入项目目录
cd vim-nerdtree

# 安装插件
sudo ./manage.sh install

# 重要：安装后需要重启终端或完全关闭所有 Vim 窗口
```

### 卸载

```bash
sudo ./manage.sh uninstall
```

### 查看状态

```bash
./manage.sh status
```

## 项目结构

```
vim-nerdtree/
├── README.md                 # 项目说明文件
├── 使用说明书.md             # 详细使用说明
├── manage.sh                 # 管理脚本（安装/卸载/状态查询）
└── nerdtree/                 # NERDTree 7.1.3 插件文件
    ├── autoload/            # 自动加载脚本
    ├── lib/                 # 核心库文件
    ├── plugin/              # 插件入口
    ├── syntax/              # 语法高亮
    ├── doc/                 # 帮助文档
    └── nerdtree_plugin/     # 插件扩展
```

## 使用方法

安装完成后，在 Vim 中执行：

**方法1：使用快捷键（推荐）**
```
按 Ctrl+n 打开/关闭 NERDTree
```

**方法2：使用命令**
```vim
:NERDTree
```

### 常用快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+n` | 打开/关闭 NERDTree（全局快捷键）|
| `o` / `Enter` | 打开文件/目录 |
| `t` | 在新标签页中打开 |
| `i` | 水平分割窗口 |
| `s` | 垂直分割窗口 |
| `q` | 关闭 NERDTree |
| `?` | 显示帮助 |

更多快捷键和详细用法请参考：[使用说明书.md](使用说明书.md)

## 脚本说明

### manage.sh - 管理脚本

**功能**：
- 自动检测系统架构（x86/ARM）
- 检查 Vim 版本
- 验证源文件完整性
- 安装到系统级目录（所有用户可用）
- 自动配置快捷键
- 可重复执行（幂等性）
- 支持卸载和状态查询

**使用方法**：
```bash
# 安装
sudo ./manage.sh install

# 卸载
sudo ./manage.sh uninstall

# 查看状态
./manage.sh status

# 查看帮助
./manage.sh help
```

## Vim 配置

安装脚本会自动在系统配置文件中添加以下配置：

- **快捷键**: `Ctrl+n` - 打开/关闭 NERDTree
- **语法高亮**: 自动启用所有文件类型的语法高亮
- **配置文件**: `/etc/vimrc` (系统级配置，所有用户生效)
- **自动备份**: 安装时自动备份原配置到 `/etc/vimrc.backup_YYYYMMDD_HHMMSS`
- **卸载恢复**: 卸载时自动恢复备份，保留系统原有配置

### 自定义快捷键

用户可以在 `~/.vimrc` 中添加个人配置：

```vim
" 设置其他快捷键
nnoremap <leader>n :NERDTreeToggle<CR>
nnoremap <leader>f :NERDTreeFind<CR>

" 其他配置选项
let g:NERDTreeWinSize = 31           " 窗口宽度
let g:NERDTreeShowHidden = 1         " 显示隐藏文件
```

**注意**: 如果不想在启动时自动打开 NERDTree，请不要在配置中添加：
```vim
" 不要添加这一行（除非你想要自动打开）
autocmd vimenter * NERDTree
```

## 常见问题

### Q1: 如何验证安装是否成功？

**方法1**: 使用状态查询
```bash
./manage.sh status
```

**方法2**: 在 Vim 中测试
```bash
vim -c ":NERDTree"
```
如果左侧出现文件树窗口，说明安装成功。

### Q2: 支持哪些 Vim 版本？

支持 Vim 7.3 及更高版本。使用 `vim --version` 查看当前版本。

### Q3: 可以在离线环境使用吗？

可以。本安装包已包含所有必要的文件，无需联网。

### Q4: 如何卸载？

```bash
sudo ./manage.sh uninstall
```

### Q5: 所有用户都能使用吗？

是的。本安装方案将插件安装到 `/usr/share/vim/vimfiles`，系统所有用户均可使用。

### Q6: 快捷键不工作怎么办？

1. 确认配置已添加：`grep "NERDTree" /etc/vimrc`
2. 重新打开 Vim（必须完全关闭所有 Vim 窗口）
3. 在 Vim 中测试：`:map <C-n>` 查看快捷键映射
4. 如果仍不工作，可能需要重启终端会话

### Q7: 如何自定义配置？

编辑 `~/.vimrc` 文件添加个人配置，不会影响全局配置。

## 技术支持

- **详细文档**: [使用说明书.md](使用说明书.md)
- **Vim 内置帮助**: 安装后在 Vim 中执行 `:help NERDTree`
- **项目主页**: https://github.com/preservim/nerdtree

## 版本信息

- **NERDTree 版本**: 7.1.3
- **安装包版本**: 1.3
- **更新日期**: 2026-01-29

## 更新日志

### v1.3 (2026-01-29)
- ✅ 添加语法高亮自动配置（所有文件类型）
- ✅ 添加配置自动备份和恢复功能
- ✅ 改进卸载逻辑，保留系统原有配置
- ✅ 优化项目结构（manage.sh 移至根目录）
- ✅ 删除非必要文件，简化项目结构

### v1.2 (2026-01-29)
- ✅ 快捷键配置修改为 `/etc/vimrc`（系统级，所有用户生效）
- ✅ 删除 `/etc/vim/vimrc.local`（保持系统干净）
- ✅ 更新文档说明

### v1.1 (2026-01-29)
- ✅ 使用本地 nerdtree-7.1.3.tar.gz
- ✅ 合并安装和卸载脚本为统一的管理脚本
- ✅ 添加快捷键配置（Ctrl+n）
- ✅ 添加状态查询功能
- ✅ 默认不自动打开，通过快捷键控制

### v1.0 (2026-01-29)
- 初始版本
- 支持在线下载和安装

## 许可证

NERDTree 采用 WTFPL (Do What The F*ck You Want To Public License) 许可证。
详见：http://sam.zoy.org/wtfpl/COPYING

## 任务清单

- [x] 在不连互联网的局域网中的 vim 中安装 NERDTree
- [x] 下载 NERDTree 的 x86 和 ARM 版本到本地
- [x] 所有用户都要能使用
- [x] 生成安装脚本，做到一键安装，可重复执行
- [x] 生成使用说明书
- [x] 合并安装和卸载脚本
- [x] 添加快捷键配置（默认不自动打开）