# powershell-terminal-setup

**Repository Path**: jinyubaba/powershell-terminal-setup

## Basic Information

- **Project Name**: powershell-terminal-setup
- **Description**: Comprehensive PowerShell terminal configuration with Oh My Posh, modern CLI tools, and productivity enhancements
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PowerShell Terminal Setup

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Gitee](https://img.shields.io/badge/Gitee-powershell--terminal--setup-red)](https://gitee.com/jinyubaba/powershell-terminal-setup)
[![PowerShell](https://img.shields.io/badge/PowerShell-5.1%2B-blue)](https://docs.microsoft.com/en-us/powershell/)
[![Windows](https://img.shields.io/badge/Windows-10%2F11-blue)](https://www.microsoft.com/windows)

> 🚀 一站式 PowerShell 终端配置方案，包含 Oh My Posh 主题、现代化 CLI 工具和生产力增强功能

English | [简体中文](#简体中文)

---

## ✨ 特性

- 🎨 **Oh My Posh** - 现代化、可定制的命令行提示符主题
- 🌈 **Windows Terminal** - 精美的配色方案（Dracula, Nord 等）
- 🛠️ **CLI 工具集** - bat, eza, ripgrep, lazygit, delta, broot, fzf, fd, jq, zoxide
- 📦 **PowerShell 模块** - Terminal-Icons, z, PSFzf
- 🔧 **Git 增强** - Delta 分页器、自定义别名
- ⚡ **生产力工具** - 模糊搜索、智能导航、语法高亮

## 📸 预览

### Oh My Posh 主题

```
🔵 jinyubaba 📁 ~/projects/powershell-terminal-setup (main*) [⇡4|⇣3] →
```

### 代码搜索
```
$ rg "function" --type py ./src
src/main.py:42:      def process_data():
src/utils.py:15:    def helper_function():
```

### Git 状态
```
$ gs
On branch main
Your branch is ahead of 'origin/main' by 4 commits.
```

## 🚀 快速开始

### 系统要求

- **操作系统**: Windows 10 或更高版本
- **PowerShell**: 5.1 或更高版本（推荐 7.x）
- **包管理器**: winget（Windows 10 1809+ 内置）
- **Git**: 用于版本控制功能

### 安装方法

#### 方法 1：一键安装（推荐）

```powershell
irm "https://gitee.com/jinyubaba/powershell-terminal-setup/raw/main/install-from-web.ps1" | iex
```

#### 方法 2：克隆安装

```powershell
git clone https://gitee.com/jinyubaba/powershell-terminal-setup.git
cd powershell-terminal-setup
.\install.ps1
```

### 安装选项

```powershell
# 完整安装
.\install.ps1

# 强制重新安装所有组件
.\install.ps1 -Force

# 跳过特定步骤
.\install.ps1 -Skip "oh-my-posh,windows-terminal"
```

## 📦 安装内容

### 终端增强
- **Oh My Posh** 主题引擎（iterm2, paradox, atomic 主题）
- **Windows Terminal** 配色方案（Dracula, Nord）
- **Terminal-Icons** 文件列表图标
- **PSFzf** 模糊查找器集成
- **z** 智能目录跳转

### CLI 工具

| 工具 | 用途 | 性能提升 |
|------|------|----------|
| **bat** | 语法高亮的 `cat` 替代品 | 更好的可读性 |
| **eza** | 现代化的 `ls`（带图标和颜色） | 2-5x 更快 |
| **ripgrep (rg)** | 超快文本搜索 | 2-100x 更快 |
| **lazygit** | 交互式 Git UI | 更直观的 Git 操作 |
| **delta** | 增强的 git diff 查看器 | 更好的可读性 |
| **broot** | 交互式文件树浏览器 | 更高效的导航 |
| **fzf** | 命令行模糊查找器 | 快速搜索 |
| **fd** | 快速文件搜索（find 替代品） | 5-10x 更快 |
| **jq** | JSON 处理器 | 10-20x 更快 |
| **zoxide** | 智能目录导航 | 更好的性能 |

### Git 配置
- Delta 作为 git 分页器
- 增强的 diff 设置
- 自定义 git 快捷命令（g, gs, ga, gc, gp, gl, gd, gco）

## 📂 文件结构

```
powershell-terminal-setup/
├── SKILL.md                 # Skill 描述和使用指南（供 agent 使用）
├── README.md                # 本文件
├── CHANGELOG.md             # 版本更新记录
├── CONTRIBUTING.md          # 贡献指南
├── LICENSE                  # MIT 许可证
├── install.ps1              # 主安装脚本
├── install-from-web.ps1     # 在线安装脚本
├── profile.ps1              # PowerShell 配置文件模板
└── tools.md                 # 完整工具文档
```

## 💡 使用示例

### 代码搜索
```powershell
# 搜索 Python 文件中的函数
rg "function" --type py ./src

# 搜索并显示上下文
rg -C 3 "error" --type js

# 排除特定文件
rg --glob "!test*" "import"
```

### 文件列表
```powershell
# 带图标和颜色的列表
eza -la --icons

# 树形视图
eza -T -L 2

# 按修改时间排序
eza -t modified
```

### 代码查看
```powershell
# 查看文件（带行号）
bat --line-numbers file.py

# 查看多个文件
bat file1.py file2.py

# 显示特定行数
bat -l 50 file.py
```

### Git 操作
```powershell
gs  # git status
ga .  # git add .
gc "commit message"  # git commit -m
gp  # git push
gl  # git log graph
gd  # git diff with delta
lazygit  # 交互式 git 界面
```

### 文件导航
```powershell
z project-name  # 智能跳转
fd -e py "test"  # 搜索 Python 文件
broot  # 交互式文件浏览器
```

### JSON 处理
```powershell
# 提取字段
cat config.json | jq '.database.host'

# 过滤数组
cat data.json | jq '.items[] | select(.price < 100)'

# 格式化输出
cat data.json | jq -r '.users[] | [.name, .age] | @csv'
```

## ⚙️ 配置文件

### PowerShell 配置文件
**位置**: `$PROFILE`

包含内容：
- Oh My Posh 初始化
- 模块导入
- 自定义别名
- Git 快捷命令
- 函数定义

### Git 配置文件
**位置**: `~\.gitconfig`

包含内容：
- Delta 分页器配置
- 增强的 diff 设置

### Windows Terminal 配置
**位置**: `$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json`

包含内容：
- 配色方案
- 配置文件设置

## 📚 文档

- **[tools.md](./tools.md)** - 所有安装工具的完整文档
- **[SKILL.md](./SKILL.md)** - 详细的 skill 使用和自定义指南
- **[CHANGELOG.md](./CHANGELOG.md)** - 版本更新历史

## 🎯 推荐的额外工具

考虑安装这些额外的开发工具：

```powershell
# 代码统计
winget install tokei

# 命令基准测试
winget install hyperfine

# 磁盘使用分析
winget install dust

# 现代化的 ps 替代品
winget install procs

# 直观的查找和替换
winget install sd

# GitHub CLI
winget install GitHub.cli

# Shell 历史同步
winget install atuin
```

## 🎨 自定义

### 更改 Oh My Posh 主题

```powershell
# 下载新主题
curl -o "$HOME\.oh-my-posh\themes\mytheme.omp.json" "https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/mytheme.omp.json"

# 更新配置文件
oh-my-posh init pwsh --config "$HOME\.oh-my-posh\themes\mytheme.omp.json" | Invoke-Expression
```

### 添加自定义别名

编辑 `$PROFILE` 并添加：
```powershell
function myalias { my-command $args }
```

### 添加 Git 别名

编辑 `$PROFILE` 并添加：
```powershell
function galias { git my-command $args }
```

## ❓ 常见问题

### 安装后找不到工具？

重启 PowerShell 或运行：
```powershell
. $PROFILE
```

### 模块导入错误？

```powershell
# 更新 PowerShellGet
Install-Module -Name PowerShellGet -Force

# 重新安装模块
Install-Module -Name Terminal-Icons, PSFzf, z -Force
```

### 主题没有加载？

```powershell
# 验证主题文件存在
Test-Path "$HOME\.oh-my-posh\themes\iterm2.omp.json"
```

### Windows Terminal 配色方案没有应用？

1. 打开 Windows Terminal
2. 按 `Ctrl + ,` 打开设置
3. 选择 PowerShell 配置文件
4. 在"配色方案"下拉菜单中选择 Dracula 或 Nord
5. 保存设置

## 🔧 性能优化建议

1. 使用 `zoxide` 代替 `z` 以获得更好的性能
2. 使用 `ripgrep` 代替 `grep` 进行更快的搜索
3. 使用 `fd` 代替 `find` 进行文件搜索
4. 使用 `eza` 代替 `ls` 进行更快的目录列表
5. 如果启动慢，延迟加载重模块

## 🔄 维护

### 更新工具

```powershell
# 更新 PowerShell 模块
Update-Module Terminal-Icons, PSFzf, z

# 更新 winget 包
winget upgrade --all
```

### 清理缓存

```powershell
# 清除 PowerShell 模块缓存
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Packages\ohmyposh.cli_*\LocalCache\Local\oh-my-posh"
```

## 🤝 贡献

欢迎贡献！请查看 [CONTRIBUTING.md](./CONTRIBUTING.md) 了解详情。

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](./LICENSE) 文件了解详情

## 🙏 致谢

感谢以下开源项目：

- [Oh My Posh](https://ohmyposh.dev/)
- [bat](https://github.com/sharkdp/bat)
- [eza](https://github.com/eza-community/eza)
- [ripgrep](https://github.com/BurntSushi/ripgrep)
- [lazygit](https://github.com/jesseduffield/lazygit)
- [delta](https://github.com/dandavison/delta)
- [broot](https://github.com/Canop/broot)
- [fzf](https://github.com/junegunn/fzf)
- [fd](https://github.com/sharkdp/fd)
- [jq](https://stedolan.github.io/jq/)
- [zoxide](https://github.com/ajeetdsouza/zoxide)

## 📞 支持

- **Oh My Posh**: https://ohmyposh.dev/docs/
- **Windows Terminal**: https://github.com/microsoft/terminal
- **个别工具**: 查看各自的 GitHub 仓库

## 📊 版本信息

- **Skill 版本**: 1.0.0
- **最后更新**: 2026-03-24
- **兼容性**: Windows 10/11, PowerShell 5.1+, winget

## ⭐ 如果这个项目对你有帮助

请给一个 ⭐ Star，这会鼓励我继续维护和改进这个项目！

---

**[⬆ 回到顶部](#powershell-terminal-setup)**