Git Workspace Pro
Git Workspace Pro là tiện ích mở rộng VS Code để quản lý nhiều kho lưu trữ Git trong một không gian làm việc với cây kho lưu trữ, các thao tác trên từng kho, quy trình làm việc với nhánh và hướng dẫn giải quyết xung đột.
Tính năng
- Cây kho lưu trữ tập trung: Tự động quét và chỉ hiển thị các kho cần chú ý; kho sạch được ẩn, nhưng kho đang đồng bộ hoặc có operation vẫn được giữ
- Quản lý tệp: Stage, unstage, discard, mở tệp, xem diff
- Thao tác Git: Fetch, Pull, Pull từ nhánh khác, Push (tự động set upstream), Commit, Stage All, Unstage All
- Quản lý nhánh: Checkout, Create, Merge, Rebase từ nhánh khác
- Pull an toàn: Chọn Fast-forward Only, Rebase hoặc Merge thay vì phụ thuộc cấu hình Git của máy
- Operation control: Continue, Skip và Abort cho merge/rebase/cherry-pick/revert đang thực hiện
- Conflict editor 3-pane: Current / Result / Incoming theo phong cách IntelliJ IDEA, có Base và xử lý từng conflict hunk
- Conflict nâng cao: Hỗ trợ diff3, modify/delete, file không có marker và binary conflict
- Stash: Push (kèm tùy chọn message), Pop
- Menu thao tác: Nhấp chuột phải vào kho lưu trữ để truy cập tất cả thao tác Git
- Biểu tượng tùy chỉnh: Logo riêng cho activity bar và marketplace
- Đa ngôn ngữ: Tự động theo VS Code hoặc chọn riêng Tiếng Việt, English, 中文（简体） cho cây repo, menu Git, thông báo, History và Conflict Resolver
Đổi ngôn ngữ
Mở Command Palette và chạy Git Workspace Pro: Đổi ngôn ngữ hiển thị, sau đó chọn:
- Tự động theo ngôn ngữ VS Code
- Tiếng Việt
- English
- 中文（简体）
Bạn cũng có thể đổi tại Settings bằng cấu hình gitWorkspacePro.language.
Yêu cầu
Cài đặt
Cách 1: Cài từ file VSIX
- Tải file
git-workspace-pro-0.3.0.vsix từ Releases
- Mở VS Code
- Nhấn
Ctrl+Shift+P (Windows/Linux) hoặc Cmd+Shift+P (macOS) để mở Command Palette
- Gõ
Extensions: Install from VSIX... và chọn
- Chọn file
.vsix đã tải
- Khởi động lại VS Code
Hoặc cài bằng dòng lệnh:
code --install-extension git-workspace-pro-0.3.0.vsix
Cách 2: Build từ mã nguồn
- Clone repository:
git clone https://github.com/jinhyk21/git_extentions.git
cd git_extentions
- Cài dependencies:
npm install
- Biên dịch:
npm run compile
- Đóng gói thành VSIX (cần
vsce):
npm install -g @vscode/vsce
vsce package --allow-missing-repository
- Cài file VSIX:
code --install-extension git-workspace-pro-0.3.0.vsix
Cách sử dụng
1. Mở Activity Bar
Sau khi cài đặt, biểu tượng Git Workspace Pro sẽ xuất hiện trong Activity Bar (thanh bên trái). Nhấp vào để mở cửa sổ Repositories.
2. Cây kho lưu trữ
Cửa sổ Repositories hiển thị tất cả các kho Git trong không gian làm việc:
- Tên kho + trạng thái thay đổi (
+staged, ~unstaged, ?untracked, !conflicted)
- Tên nhánh hiện tại
- Các nhóm tệp: Conflicted, Staged, Unstaged, Untracked
3. Thao tác với tệp
Mở rộng một kho để xem các tệp đã thay đổi. Mỗi tệp có các nút inline:
| Nút |
Chức năng |
| Mở tệp |
Mở tệp để chỉnh sửa |
| Diff |
So sánh với HEAD |
| Stage (+) |
Thêm tệp unstaged/untracked vào index; file conflicted bắt buộc đi qua conflict editor |
| Unstage (-) |
Bỏ tệp khỏi index (staged) |
| Discard |
Hủy thay đổi (unstaged/untracked) |
4. Thao tác Git (Repository Actions)
Nhấp chuột phải vào một kho lưu trữ và chọn Repository Actions để mở menu thao tác:
| Thao tác |
Mô tả |
| Stage All |
Thêm tất cả tệp đã thay đổi vào index |
| Unstage All |
Bỏ tất cả tệp khỏi index |
| Commit |
Tạo commit với message |
| Fetch |
Fetch tất cả remotes và prune |
| Pull |
Pull nhánh hiện tại |
| Pull From Branch |
Pull từ nhánh khác về nhánh hiện tại |
| Push |
Push nhánh hiện tại (tự động set upstream nếu chưa có) |
| Checkout Branch |
Chuyển nhánh |
| Create Branch |
Tạo và chuyển sang nhánh mới |
| Merge Branch |
Merge nhánh đã chọn vào nhánh hiện tại |
| Rebase Onto Branch |
Rebase nhánh hiện tại lên nhánh đã chọn |
| Continue Operation |
Tiếp tục merge/rebase/cherry-pick/revert sau khi resolve |
| Skip Operation Step |
Bỏ qua commit hiện tại của rebase/cherry-pick/revert |
| Abort Operation |
Hủy operation và quay lại trạng thái trước đó |
| Stash Push |
Lưu thay đổi vào stash (kèm message tùy chọn) |
| Stash Pop |
Áp dụng stash gần nhất và xóa nó |
5. Làm mới
Nhấp chuột phải vào kho và chọn Refresh hoặc dùng nút refresh trên thanh công cụ để quét lại.
6. Resolve conflict
Khi pull, merge hoặc rebase dừng vì conflict:
- Chọn Resolve First Conflict hoặc mở nhóm Conflicted trong repository.
- Conflict editor hiển thị ba cột Current, Result và Incoming; phiên bản Base có thể mở ở phía dưới.
- Chọn Accept Current, Accept Incoming, Accept Both hoặc sửa trực tiếp cột Result.
- Chọn Apply & Stage. Extension tự mở conflict tiếp theo nếu vẫn còn.
- Khi file cuối cùng được resolve, chọn Continue để chạy
merge --continue hoặc rebase --continue.
- Có thể chọn Abort từ dòng operation trong repository nếu muốn quay lại trạng thái ban đầu.
Phát triển
Cấu trúc dự án
git_extentions/
├── src/
│ ├── core/
│ │ ├── errors/ # Lỗi tùy chỉnh
│ │ ├── eventbus/ # Event bus
│ │ ├── git/ # GitAdapter, GitProcessRunner
│ │ └── repository/ # RepositoryManager, RepositoryScanner
│ ├── extension/
│ │ ├── activate.ts # Entry point + TreeProvider
│ │ ├── deactivate.ts
│ │ └── commands/ # Đăng ký command
│ └── shared/
│ ├── constants/ # Error codes
│ └── types/ # TypeScript types
├── media/ # Logo và icon
│ ├── activitybar.svg
│ ├── logo.png
│ └── logo.svg
├── docs/ # Tài liệu thiết kế
├── package.json
└── tsconfig.json
Lệnh
npm install # Cài dependencies
npm run compile # Biên dịch TypeScript
npm run watch # Biên dịch tự động
npm run lint # Chạy ESLint
npm test # Kiểm tra (chạy compile)
Chạy ở chế độ phát triển
- Mở thư mục trong VS Code
- Nhấn
F5 để mở Extension Development Host
- Mở một workspace có nhiều Git repo để test
Đóng gói
npm install -g @vscode/vsce
vsce package --allow-missing-repository
File .vsix sẽ được tạo trong thư mục gốc.
License
MIT
