posh-git-viys

🧩posh-git-viys

PowerShell Git Prompt 配置器，posh-git-viys

💡 项目作用

这个项目通过两个脚本文件，自动配置并美化你的 PowerShell Git 提示符，让你在命令行里更清晰地看到当前 Git 分支状态、改动情况、是否与远程同步等信息。

不用安装复杂的插件，也不用手动修改配置文件。只需运行一个脚本，即可：

• ✅ 自动备份原始 PowerShell 配置
• ✅ 安装 Git 状态提示脚本
• ✅ 实时显示 Git 分支名和同步状态
• ✅ 根据工作区状态切换颜色，快速识别变更

---

📁 包含文件

1. install_posh.ps1

安装脚本，一键完成配置修改和脚本部署。

它做了什么：

• 检查 $PROFILE 是否存在，若存在则自动备份。
• 将 posh-git-viys.ps1 复制到 $HOME\Documents\PowerShell。
• 修改 $PROFILE 文件，写入引用语句（自动加载脚本）。
• 立即应用修改，生效新的 Git 提示符功能。

2. posh-git-viys.ps1

自定义 Git 状态提示符函数 prompt。

它做了什么：

• 检测当前是否在 Git 仓库中。
• 显示当前 Git 分支名，带同步状态符号（↑↓↕✓）。
  • ↕：本地和远程分支均有变更（变红）
  • ↑：本地分支领先远程分支（变青）
  • ↓：本地分支落后远程分支（变蓝）
  • ✓：本地和远程分支同步（变绿）
• 检查文件是否有以下改动：
  • 未暂存改动（变灰）
  • 已暂存改动（变黄）
  • 未追踪文件（也变灰）
• 根据状态自动变色，快速定位问题。

---

🚀 快速使用

1. 将两个脚本文件放在同一目录。
2. 在 PowerShell 中运行安装脚本：

.\install_install.ps1

1. 安装完成后，每次打开 PowerShell，都会自动启用 Git 状态提示符。

---

🧪 提示符显示示例

PS C:\MyRepo ⎇ develop ↑ >

说明：

• 当前分支：develop
• 本地比远程领先（↑）

颜色说明：

状态	显示颜色
同步 / 干净状态	Green
有未暂存改动或未追踪文件	DarkGray
有已暂存改动	Yellow
分支同步差异（无本地变动）	Cyan / Blue / DarkRed

---

🛠️ 注意事项

• 如果首次运行提示权限错误，请执行：

  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

• 也可通过 . $PROFILE 手动重新加载配置。