git-add - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

git-add - Thêm nội dung tệp vào chỉ mục

SYNOPSIS

git thêm vào [--verbose | -v] [--dry-run | -n] [- lực lượng | -f] [- tương tác | -i] [--patch | -P]
[- chỉnh sửa | -e] [- [no-] hết | - [không-] bỏ qua-loại bỏ | [--cập nhật | -u]]
[--intent-to-add | -N] [--làm mới] [- lỗi lớn] [- thiếu lỗi]
[-] [ ...]

MÔ TẢ

Lệnh này cập nhật chỉ mục bằng cách sử dụng nội dung hiện tại được tìm thấy trong cây làm việc, để
chuẩn bị nội dung được dàn dựng cho lần cam kết tiếp theo. Nó thường thêm nội dung hiện tại của
các đường dẫn hiện có nói chung, nhưng với một số tùy chọn, nó cũng có thể được sử dụng để thêm nội dung với
chỉ một phần của những thay đổi được thực hiện đối với tệp cây làm việc được áp dụng hoặc loại bỏ các đường dẫn
không tồn tại trong cây làm việc nữa.

"Chỉ mục" chứa một ảnh chụp nhanh nội dung của cây làm việc và nó là ảnh chụp nhanh này
được coi là nội dung của cam kết tiếp theo. Do đó, sau khi thực hiện bất kỳ thay đổi nào đối với
cây làm việc và trước khi chạy lệnh cam kết, bạn phải sử dụng lệnh add để thêm
bất kỳ tệp mới hoặc được sửa đổi nào đối với chỉ mục.

Lệnh này có thể được thực hiện nhiều lần trước một lần cam kết. Nó chỉ thêm nội dung của
(các) tệp được chỉ định tại thời điểm lệnh thêm được chạy; nếu bạn muốn những thay đổi tiếp theo
bao gồm trong cam kết tiếp theo, sau đó bạn phải chạy lại git add để thêm nội dung mới vào
mục lục.

Lệnh git status có thể được sử dụng để có được một bản tóm tắt về những tệp nào có những thay đổi
được tổ chức cho lần cam kết tiếp theo.

Lệnh git add sẽ không thêm các tệp bị bỏ qua theo mặc định. Nếu có bất kỳ tệp nào bị bỏ qua
được chỉ định rõ ràng trên dòng lệnh, git add sẽ không thành công với danh sách các tệp bị bỏ qua.
Các tệp bị bỏ qua được truy cập bằng đệ quy thư mục hoặc tên tệp globbing được thực hiện bởi Git (trích dẫn
của bạn trước vỏ) sẽ bị bỏ qua một cách im lặng. Các git thêm vào lệnh có thể được sử dụng để
thêm các tệp bị bỏ qua với tùy chọn -f (force).

Xin vui lòng xem git-cam kết(1) để biết các cách thay thế để thêm nội dung vào cam kết.

LỰA CHỌN

...
Các tệp để thêm nội dung từ. Fileglobs (ví dụ: * .c) có thể được cung cấp để thêm tất cả các kết quả phù hợp
các tập tin. Ngoài ra, tên thư mục đứng đầu (ví dụ: dir để thêm dir / file1 và dir / file2) có thể
được cung cấp để cập nhật chỉ mục để phù hợp với trạng thái hiện tại của toàn bộ thư mục (ví dụ:
chỉ định dir sẽ không chỉ ghi lại một tệp dir / file1 được sửa đổi trong cây làm việc,
tệp dir / file2 được thêm vào cây làm việc, nhưng tệp dir / file3 cũng bị xóa khỏi
cây làm việc. Lưu ý rằng các phiên bản cũ hơn của Git được sử dụng để bỏ qua các tệp đã bị xóa; sử dụng
- không có tùy chọn tất cả nếu bạn muốn thêm các tệp đã sửa đổi hoặc mới nhưng bỏ qua các tệp đã bị xóa.

-n, - chạy thử
Không thực sự thêm (các) tệp, chỉ cần hiển thị nếu chúng tồn tại và / hoặc sẽ bị bỏ qua.

-v, --verbose
Dài dòng.

-f, - lực lượng
Cho phép thêm các tệp bị bỏ qua khác.

-i, - tương tác
Thêm nội dung đã sửa đổi trong cây làm việc một cách tương tác vào chỉ mục. Đường dẫn tùy chọn
các đối số có thể được cung cấp để giới hạn hoạt động đối với một tập con của cây làm việc. Nhìn thấy
"Chế độ tương tác" để biết chi tiết.

-p, --patch
Tương tác chọn nhiều nhóm bản vá giữa chỉ mục và cây công việc và thêm chúng
vào chỉ mục. Điều này cho phép người dùng có cơ hội xem xét sự khác biệt trước khi thêm
nội dung sửa đổi vào chỉ mục.

Điều này có hiệu quả chạy add --interactive, nhưng bỏ qua menu lệnh ban đầu và
trực tiếp chuyển đến lệnh con vá lỗi. Xem “Chế độ tương tác” để biết chi tiết.

-e, --edit
Mở sự khác biệt so với chỉ mục trong trình chỉnh sửa và để người dùng chỉnh sửa nó. Sau khi người biên tập
đã được đóng, điều chỉnh tiêu đề phân đoạn và áp dụng bản vá cho chỉ mục.

Mục đích của tùy chọn này là chọn và chọn các dòng của bản vá để áp dụng, hoặc thậm chí
để sửa đổi nội dung của các dòng sẽ được dàn dựng. Điều này có thể nhanh hơn và linh hoạt hơn
so với việc sử dụng bộ chọn tập tin tương tác. Tuy nhiên, bản thân rất dễ nhầm lẫn và
tạo một bản vá không áp dụng cho chỉ mục. Xem CHỈNH SỬA CÁC TRANG dưới đây.

-u, - cập nhật
Cập nhật chỉ mục ngay nơi nó đã có mục nhập khớp . Điều này loại bỏ
cũng như sửa đổi các mục nhập chỉ mục để phù hợp với cây làm việc, nhưng không thêm tệp mới.

Nếu không được cung cấp khi tùy chọn -u được sử dụng, tất cả các tệp được theo dõi trong toàn bộ
cây làm việc được cập nhật (các phiên bản cũ của Git được sử dụng để giới hạn bản cập nhật hiện tại
thư mục và các thư mục con của nó).

-A, - tất cả, - không-bỏ qua-loại bỏ
Cập nhật chỉ mục không chỉ nơi cây làm việc có tệp phù hợp nhưng
cũng là nơi chỉ mục đã có mục nhập. Điều này thêm, sửa đổi và loại bỏ chỉ mục
mục nhập để phù hợp với cây làm việc.

Nếu không được cung cấp khi tùy chọn -A được sử dụng, tất cả các tệp trong toàn bộ cây làm việc
được cập nhật (các phiên bản cũ của Git được sử dụng để giới hạn cập nhật cho thư mục hiện tại và
các thư mục con của nó).

- không có tất cả, - loại bỏ lớn
Cập nhật chỉ mục bằng cách thêm các tệp mới chưa biết vào chỉ mục và các tệp đã sửa đổi
trong cây làm việc, nhưng bỏ qua các tệp đã bị xóa khỏi cây làm việc.
Tùy chọn này là không chọn khi không Được sử dụng.

Tùy chọn này chủ yếu để giúp những người dùng đã quen với các phiên bản Git cũ hơn, có
"git thêm ... "là từ đồng nghĩa với" git add --no-all ...", I E
bỏ qua các tệp đã bị loại bỏ.

-N, --có ý định thêm
Chỉ ghi lại thực tế là đường dẫn sẽ được thêm vào sau này. Một mục cho đường dẫn là
được đặt trong chỉ mục không có nội dung. Điều này hữu ích cho, trong số những thứ khác, hiển thị
nội dung chưa được phân giai đoạn của các tệp đó với git diff và cam kết chúng bằng git commit
-Một.

--Làm tươi
Không thêm (các) tệp mà chỉ làm mới thông tin stat () của chúng trong chỉ mục.

- lỗi nặng
Nếu không thể thêm một số tệp do lỗi lập chỉ mục chúng, không hủy bỏ
hoạt động, nhưng tiếp tục thêm những người khác. Lệnh sẽ vẫn thoát với khác XNUMX
trạng thái. Biến cấu hình add.ignoreErrors có thể được đặt thành true để thực hiện điều này
hành vi mặc định.

- thiếu sót
Tùy chọn này chỉ có thể được sử dụng cùng với --dry-run. Bằng cách sử dụng tùy chọn này, người dùng
có thể kiểm tra xem có bất kỳ tệp nào trong số các tệp đã cho sẽ bị bỏ qua hay không, bất kể chúng đã được
có trong cây công việc hay không.

--
Tùy chọn này có thể được sử dụng để tách các tùy chọn dòng lệnh khỏi danh sách tệp,
(hữu ích khi tên tệp có thể bị nhầm với các tùy chọn dòng lệnh).

CẤU HÌNH

Biến cấu hình tùy chọn core.excludesFile chỉ ra một đường dẫn đến một tệp
chứa các mẫu tên tệp để loại trừ khỏi git-add, tương tự như
$ GIT_DIR / thông tin / loại trừ. Các mẫu trong tệp loại trừ được sử dụng ngoài các mẫu trong
thông tin / loại trừ. Nhìn thấy gitignore(5).

VÍ DỤ

· Thêm nội dung từ tất cả các tệp * .txt trong thư mục Tài liệu và
thư mục con:

$ git thêm Tài liệu / \ *. txt

Lưu ý rằng dấu hoa thị * được trích dẫn từ shell trong ví dụ này; điều này cho phép
lệnh bao gồm các tệp từ thư mục con của Thư mục / tài liệu.

· Cân nhắc thêm nội dung từ tất cả các tập lệnh git - *. Sh:

$ git thêm git - *. sh

Bởi vì ví dụ này cho phép shell mở rộng dấu hoa thị (tức là bạn đang liệt kê
tệp một cách rõ ràng), nó không coi là subir / git-foo.sh.

TƯƠNG TÁC PHƯƠNG THỨC

Khi lệnh vào chế độ tương tác, nó sẽ hiển thị đầu ra của tình trạng
lệnh con, và sau đó đi vào vòng lặp lệnh tương tác của nó.

Vòng lặp lệnh hiển thị danh sách các lệnh con có sẵn và đưa ra lời nhắc "Bây giờ>".
Nói chung, khi lời nhắc kết thúc bằng một >, bạn chỉ có thể chọn một trong các lựa chọn
đã cho và nhập return, như thế này:

*** Lệnh ***
1: trạng thái 2: cập nhật 3: hoàn nguyên 4: thêm chưa được theo dõi
5: bản vá 6: khác 7: bỏ 8: trợ giúp
Cái gì bây giờ> 1

Bạn cũng có thể nói s hoặc sta hoặc trạng thái ở trên miễn là sự lựa chọn là duy nhất.

Vòng lặp lệnh chính có 6 lệnh con (cộng với trợ giúp và thoát).

tình trạng
Điều này cho thấy sự thay đổi giữa HEAD và chỉ mục (tức là những gì sẽ được cam kết nếu bạn nói
git commit), và giữa các tệp chỉ mục và cây làm việc (tức là những gì bạn có thể tạo
hơn nữa trước khi cam kết git bằng cách sử dụng git add) cho mỗi đường dẫn. Một đầu ra mẫu trông giống như
điều này:

đường dẫn không theo giai đoạn
1: nhị phân không có gì foo.png
2: + 403 / -35 + 1 / -1 git-add - tương tác.perl

Nó cho thấy foo.png có sự khác biệt so với HEAD (nhưng đó là hệ nhị phân nên số dòng
không thể được hiển thị) và không có sự khác biệt giữa bản sao được lập chỉ mục và cây làm việc
phiên bản (nếu phiên bản cây làm việc cũng khác, nhị phân sẽ được hiển thị
Ở vị trí không). Tệp khác, git-add --ractive.perl, có 403 dòng được thêm vào
và 35 dòng bị xóa nếu bạn cam kết những gì có trong chỉ mục, nhưng tệp cây làm việc có
sửa đổi thêm (một lần thêm và một lần xóa).

cập nhật
Điều này hiển thị thông tin trạng thái và đưa ra lời nhắc "Cập nhật >>". Khi lời nhắc
kết thúc bằng đôi >>, bạn có thể thực hiện nhiều lựa chọn, được nối với
khoảng trắng hoặc dấu phẩy. Ngoài ra bạn có thể nói phạm vi. Ví dụ: "2-5 7,9" để chọn 2,3,4,5,7,9
khỏi danh sách. Nếu số thứ hai trong một phạm vi bị bỏ qua, tất cả các bản vá lỗi còn lại là
Lấy. Ví dụ: "7-" để chọn 7,8,9 từ danh sách. Bạn có thể nói * để chọn mọi thứ.

Những gì bạn chọn sau đó được đánh dấu bằng *, như thế này:

đường dẫn không theo giai đoạn
1: nhị phân không có gì foo.png
* 2: + 403 / -35 + 1 / -1 git-add - tương tác.perl

Để xóa lựa chọn, hãy đặt tiền tố đầu vào bằng - như sau:

Cập nhật >> -2

Sau khi lựa chọn, hãy trả lời bằng một dòng trống để phân chia nội dung làm việc
tệp cây cho các đường dẫn đã chọn trong chỉ mục.

trở lại
Điều này có giao diện người dùng rất giống với cập nhậtvà thông tin theo giai đoạn cho các đường dẫn đã chọn
được hoàn nguyên về phiên bản HEAD. Hoàn nguyên các đường dẫn mới làm cho chúng không bị theo dõi.

thêm không theo dõi
Điều này có giao diện người dùng rất giống với cập nhật và trở lạivà cho phép bạn thêm các đường dẫn không được theo dõi vào
chỉ số.

bản vá
Điều này cho phép bạn chọn một con đường trong số tình trạng như sự lựa chọn. Sau khi chọn con đường,
nó trình bày sự khác biệt giữa chỉ mục và tệp cây làm việc và hỏi bạn nếu bạn
muốn phân giai đoạn thay đổi của từng khúc. Bạn có thể chọn một trong các tùy chọn sau và
loại trả lại:

y - giai đoạn này hunk
n - không giai đoạn này
q - bỏ; không giai đoạn này hoặc bất kỳ cái nào còn lại
a - giai đoạn phân tích này và tất cả các phân đoạn sau đó trong tệp
d - không xếp đoạn này hoặc bất kỳ đoạn nào sau này trong tệp
g - chọn một phần để đi đến
/ - tìm kiếm một đoạn đường phù hợp với regex đã cho
j - để phần này chưa quyết định, xem phần tiếp theo chưa quyết định
J - để phần này chưa quyết định, xem phần tiếp theo
k - để phần này chưa quyết định, xem phần chưa quyết định trước đó
K - để phần này chưa quyết định, xem phần trước
s - chia nhóm hiện tại thành các nhóm nhỏ hơn
e - chỉnh sửa thủ công tập tin rác hiện tại
? - trợ giúp in ấn

Sau khi quyết định số phận cho tất cả các đồng loại, nếu có bất kỳ chú chó nào được chọn, chỉ số
được cập nhật với các nhóm đã chọn.

Bạn có thể bỏ qua việc phải nhập return ở đây, bằng cách đặt biến cấu hình
Tương tác.singleKey thành true.

khác
Điều này cho phép bạn xem lại những gì sẽ được cam kết (tức là giữa HEAD và chỉ mục).

Chỉnh sửa BẢN VÁ LỖI

Gọi git add -e hoặc chọn e từ bộ chọn tệp tương tác sẽ mở ra một bản vá trong
biên tập viên của bạn; sau khi trình chỉnh sửa thoát ra, kết quả được áp dụng cho chỉ mục. Bạn được tự do
thực hiện các thay đổi tùy ý đối với bản vá, nhưng lưu ý rằng một số thay đổi có thể gây nhầm lẫn
kết quả, hoặc thậm chí dẫn đến một bản vá không thể được áp dụng. Nếu bạn muốn hủy bỏ
hoàn toàn hoạt động (tức là không có gì mới trong chỉ mục), chỉ cần xóa tất cả các dòng của
vá. Danh sách dưới đây mô tả một số điều phổ biến bạn có thể thấy trong một bản vá và
các thao tác chỉnh sửa có ý nghĩa đối với chúng.

nội dung thêm vào
Nội dung đã thêm được thể hiện bằng các dòng bắt đầu bằng "+". Bạn có thể ngăn chặn việc dàn dựng bất kỳ
bổ sung dòng bằng cách xóa chúng.

nội dung đã xóa
Nội dung đã xóa được thể hiện bằng các dòng bắt đầu bằng "-". Bạn có thể ngăn chặn việc dàn dựng
loại bỏ của họ bằng cách chuyển đổi "-" thành "" (dấu cách).

nội dung sửa đổi
Nội dung đã sửa đổi được thể hiện bằng các dòng "-" (xóa nội dung cũ) theo sau là
Các dòng "+" (thêm nội dung thay thế). Bạn có thể ngăn việc dàn dựng sửa đổi
bằng cách chuyển đổi các dòng "-" thành "" và xóa các dòng "+". Hãy coi chừng rằng chỉ sửa đổi
một nửa số cặp có khả năng đưa ra những thay đổi khó hiểu đối với chỉ mục.

Ngoài ra còn có các hoạt động phức tạp hơn có thể được thực hiện. Nhưng hãy cẩn thận vì
bản vá chỉ được áp dụng cho chỉ mục và không phải cây làm việc, cây làm việc sẽ xuất hiện
để "hoàn tác" thay đổi trong chỉ mục. Ví dụ: giới thiệu một dòng mới vào chỉ mục
không nằm trong HEAD hay cây làm việc sẽ tạo dòng mới cho cam kết, nhưng
dòng sẽ được hoàn nguyên trong cây làm việc.

Tránh sử dụng các cấu trúc này hoặc làm như vậy hết sức thận trọng.

loại bỏ nội dung chưa được chỉnh sửa
Nội dung không khác biệt giữa chỉ mục và cây làm việc có thể được hiển thị trên
dòng ngữ cảnh, bắt đầu bằng dấu "" (dấu cách). Bạn có thể sắp xếp các dòng ngữ cảnh để xóa
bằng cách chuyển đổi khoảng trắng thành dấu "-". Tệp cây làm việc kết quả sẽ xuất hiện
thêm lại nội dung.

sửa đổi nội dung hiện có
Người ta cũng có thể sửa đổi các dòng ngữ cảnh bằng cách sắp xếp chúng để loại bỏ (bằng cách chuyển đổi "" thành
"-") và thêm một dòng "+" với nội dung mới. Tương tự, người ta có thể sửa đổi các dòng "+"
cho các bổ sung hoặc sửa đổi hiện có. Trong mọi trường hợp, sửa đổi mới sẽ
xuất hiện hoàn nguyên trong cây làm việc.

Nội dung mới
Bạn cũng có thể thêm nội dung mới không tồn tại trong bản vá; chỉ cần thêm các dòng mới,
mỗi bắt đầu bằng "+". Phần bổ sung sẽ xuất hiện hoàn nguyên trong cây làm việc.

Cũng có một số thao tác nên tránh hoàn toàn, vì chúng sẽ làm cho
không thể áp dụng bản vá:

· Thêm các dòng ngữ cảnh ("") hoặc loại bỏ ("-")

· Xóa ngữ cảnh hoặc xóa dòng

· Sửa đổi nội dung của ngữ cảnh hoặc dòng xóa

Sử dụng git-add trực tuyến bằng các dịch vụ onworks.net