Worktree

Tạo worktree#

1. Trong một ô nằm trong kho, nhấp Worktree trên thanh ô (cũng có trong danh sách nhánh).
2. Trong Tạo từ, chọn Nhánh hoặc Pull request.
3. Chọn Nhánh gốc (hoặc pull request) và nhập tên Nhánh mới.
4. Chọn Nơi tạo và, nếu muốn, một ghi chú phiên.
5. Nhấn Tạo. Một phiên mới mở ra trong thư mục của worktree.

Worktree được đặt ở đâu#

Ngoài kho (mặc định)

Các worktree được gom trong một thư mục mang tên kho, ví dụ ~/worktrees/acme-app/feature-login. Nhập đường dẫn tuyệt đối, ~ hoặc ... Tệp .gitignore của bạn không bị động đến.

Trong kho

Worktree được đặt trong một thư mục bên trong kho. Nếu thư mục đó chưa bị bỏ qua, nó sẽ được thêm vào .gitignore ở gốc (như một thay đổi mã nguồn bình thường).

Sao chép tệp bị bỏ qua#

Một worktree mới không có tệp nào bị git bỏ qua, nên thường chưa chạy được ngay. Với Tệp bị bỏ qua: Sao chép từ checkout này (mặc định), PATerminal sao chép các tệp như .env, node_modules và .venv từ checkout hiện tại sang worktree mới, kèm chỉ báo tiến độ. Chọn Không sao chép để bỏ qua.

Worktree từ pull request#

Chọn Pull request làm nguồn để liệt kê các pull request đang mở (qua gh của bạn). PATerminal tạo worktree trên nhánh của PR và mở nó thành phiên — lý tưởng để đánh giá hoặc sửa PR trong khi checkout chính vẫn tiếp tục làm việc. Nếu đã có worktree cho nhánh đó, nó sẽ được dùng lại.

Quản lý worktree#

Danh sách worktree trong cửa sổ Git hiển thị mọi worktree cùng nhánh và trạng thái (hiện tại, chính, bị khóa, bị thiếu). Xóa từng cái, hoặc chọn nhiều cái và nhấn Xóa mục đã chọn. Xóa worktree vẫn giữ nhánh của nó; không thể xóa worktree chính và worktree hiện tại. Xóa bắt buộc được đề xuất khi Git từ chối vì có thay đổi cục bộ.

Mặc định cho worktree#

Cài đặt → Vị trí mặc định của worktree đặt vị trí mặc định và có sao chép tệp bị bỏ qua hay không. Bật Automatically fill in the branch name để có tên được tạo từ ngày, giờ và một hậu tố ngẫu nhiên ngắn. Các mặc định này cũng áp dụng khi worktree được tạo từ issue hoặc bởi chế độ cặp.