git-commit - Dalam talian dalam Awan

JADUAL:

NAMA

git-commit - Rekod perubahan pada repositori

SINOPSIS

pergi melakukan [-a | --interaktif | --patch] [-s] [-v] [-u ] [--pindaan]
[--dry-run] [(-c | -C | --fixup | --skuasy) ]
[-F | -m ] [--reset-author] [--benarkan-kosong]
[--benarkan-mesej-kosong] [--tidak-sahkan] [-e] [--author= ]
[--tarikh= ] [--pembersihan= ] [--[tiada status]
[-i | -o] [-S[ ]] [--] [ ...]

DESCRIPTION

Menyimpan kandungan semasa indeks dalam komit baharu bersama-sama dengan mesej log daripada
pengguna menerangkan perubahan.

Kandungan yang akan ditambah boleh ditentukan dalam beberapa cara:

1. dengan menggunakan pergi menambah untuk "menambah" perubahan secara berperingkat pada indeks sebelum menggunakan melakukan
arahan (Nota: walaupun fail yang diubah suai mesti "ditambah");

2. dengan menggunakan pergi rm untuk mengalih keluar fail daripada pokok kerja dan indeks, sekali lagi sebelum ini
menggunakan melakukan perintah;

3. dengan menyenaraikan fail sebagai hujah kepada melakukan perintah, dalam hal ini komit akan
abaikan perubahan yang dipentaskan dalam indeks, dan sebaliknya merekodkan kandungan semasa
fail tersenarai (yang mesti sudah diketahui oleh Git);

4. dengan menggunakan suis -a dengan melakukan perintah untuk "menambah" perubahan secara automatik daripada semua
fail yang diketahui (iaitu semua fail yang telah disenaraikan dalam indeks) dan secara automatik
"rm" fail dalam indeks yang telah dialih keluar daripada pokok kerja, dan kemudian lakukan
komitmen sebenar;

5. dengan menggunakan suis --interactive atau --patch dengan melakukan perintah untuk memutuskan satu
oleh satu fail atau hunks yang harus menjadi sebahagian daripada komit, sebelum memuktamadkan
operasi. Lihat bahagian "Mod Interaktif" pada git-add(1) untuk belajar bagaimana untuk beroperasi
mod ini.

Pilihan --dry-run boleh digunakan untuk mendapatkan ringkasan tentang perkara yang disertakan oleh mana-mana
di atas untuk komit seterusnya dengan memberikan set parameter yang sama (pilihan dan laluan).

Jika anda membuat komitmen dan kemudian mencari kesilapan serta-merta selepas itu, anda boleh pulih daripada
ia dengan pergi menetapkan semula.

PILIHAN

-a, --semua
Beritahu arahan untuk secara automatik mementaskan fail yang telah diubah suai dan dipadam, tetapi
fail baharu yang anda tidak beritahu Git tidak terjejas.

-p, --tampalan
Gunakan antara muka pemilihan tampung interaktif untuk memilih perubahan yang akan dilakukan. Lihat
git-add(1) untuk butiran.

-C , --reuse-message=
Ambil objek komit sedia ada, dan gunakan semula mesej log dan kepengarangan
maklumat (termasuk cap masa) semasa membuat komit.

-c , --reedit-message=
suka -C, tetapi dengan -c editor dipanggil, supaya pengguna boleh mengedit lagi
commit mesej.

--fixup=
Bina mesej komit untuk digunakan dengan rebase --autosquash. Mesej komit akan
menjadi baris subjek daripada komit yang ditentukan dengan awalan "fixup! ". Lihat git-
melunaskan semula(1) untuk butiran.

--labu=
Bina mesej komit untuk digunakan dengan rebase --autosquash. Mesej komit
baris subjek diambil daripada komit yang ditentukan dengan awalan "skuasy! ". Boleh jadi
digunakan dengan pilihan mesej komit tambahan (-m/-c/-C/-F). Lihat git-rebase(1) untuk
butiran.

--set semula-pengarang
Apabila digunakan dengan pilihan -C/-c/--pindaan, atau apabila melakukan selepas aa bercanggah
cherry-pick, mengisytiharkan bahawa kepengarangan komit yang terhasil kini adalah milik
pengkomitmen. Ini juga memperbaharui cap masa pengarang.

--pendek
Apabila melakukan larian kering, berikan output dalam format pendek. Lihat git-status(1) untuk
butiran. Menyiratkan --lari kering.

--cawangan
Tunjukkan cawangan dan maklumat penjejakan walaupun dalam format pendek.

--porselin
Apabila melakukan larian kering, berikan output dalam format sedia porselin. Lihat git-status(1)
untuk butiran. Menyiratkan --lari kering.

--panjang
Apabila melakukan larian kering, berikan output dalam format panjang. Menyiratkan --lari kering.

-z, --null
Apabila menunjukkan output status pendek atau porselin, tamatkan entri dalam output status
dengan NUL, bukannya LF. Jika tiada format diberikan, membayangkan format output --porcelain.

-F , --file=
Ambil mesej komit dari fail yang diberikan. guna - untuk membaca mesej daripada
input standard.

--pengarang=
Gantikan pengarang komit. Tentukan pengarang eksplisit menggunakan AU Thor standard
<[e-mel dilindungi]> format. Jika tidak diandaikan sebagai corak dan digunakan
untuk mencari komit sedia ada oleh pengarang itu (iaitu rev-list --all -i
--pengarang= ); pengarang komit kemudiannya disalin daripada komit pertama yang ditemui.

--tarikh=
Gantikan tarikh pengarang yang digunakan dalam komit.

-m , --message=
Gunakan yang diberikan sebagai mesej komit. Jika berbilang -m pilihan diberikan, mereka
nilai digabungkan sebagai perenggan yang berasingan.

-t , --template=
Apabila mengedit mesej komit, mulakan editor dengan kandungan dalam fail yang diberikan.
Pembolehubah konfigurasi commit.template sering digunakan untuk memberikan pilihan ini
secara tersirat kepada perintah itu. Mekanisme ini boleh digunakan oleh projek yang ingin membimbing
peserta dengan beberapa petunjuk tentang apa yang perlu ditulis dalam mesej dalam susunan apa. Sekiranya
pengguna keluar dari editor tanpa mengedit mesej, komit dibatalkan. Ini tidak mempunyai
kesan apabila mesej diberikan dengan cara lain, cth dengan pilihan -m atau -F.

-s, --signoff
Tambah baris Ditandatangani oleh pemadam pada penghujung mesej log komit. The
makna signoff bergantung pada projek, tetapi ia biasanya memperakui komit itu
mempunyai hak untuk menyerahkan karya ini di bawah lesen yang sama dan bersetuju dengan Pembangun
Sijil Asal (lihat http://developercertificate.org/ untuk maklumat lanjut).

-n, --tidak-sahkan
Pilihan ini memintas cangkuk pra-komit dan komit-msg. Lihat juga githooks(5).

--benarkan-kosong
Biasanya merekodkan komit yang mempunyai pokok yang sama persis dengan komit induk tunggalnya ialah a
kesilapan, dan perintah itu menghalang anda daripada membuat komitmen sedemikian. Pilihan ini memintas
keselamatan, dan terutamanya untuk digunakan oleh skrip antara muka SCM asing.

--benarkan-kosong-mesej
Seperti --allow-empty arahan ini terutamanya untuk digunakan oleh skrip antara muka SCM asing.
Ia membolehkan anda membuat komit dengan mesej komit kosong tanpa menggunakan paip
arahan seperti git-commit-tree(1).

--pembersihan=
Pilihan ini menentukan cara mesej komit yang dibekalkan harus dibersihkan sebelum ini
melakukan. The boleh menjadi jalur, ruang putih, kata kerja, gunting atau lalai.

jalur
Potong baris kosong di hadapan dan di belakang, ruang kosong di belakang, ulasan dan
runtuhkan baris kosong berturut-turut.

ruang kosong
Sama seperti jalur kecuali #komentar tidak dialih keluar.

kata demi kata
Jangan ubah mesej sama sekali.

gunting
Sama seperti ruang putih, kecuali semuanya daripada (dan termasuk) baris "#
------------------------- >8 ----------------------- " dipotong jika mesej
adalah untuk disunting. "#" boleh disesuaikan dengan core.commentChar.

lalai
Sama seperti jalur jika mesej ingin diedit. Jika tidak, ruang kosong.

Lalai boleh diubah oleh komited.pembersihan pembolehubah konfigurasi (lihat git-
config(1)).

-e, - edit
Mesej yang diambil dari fail dengan -F, baris arahan dengan -m, dan dari objek komit dengan
-C biasanya digunakan sebagai mesej log komit yang tidak diubah suai. Pilihan ini membolehkan anda lebih jauh
edit mesej yang diambil daripada sumber ini.

--tiada-edit
Gunakan mesej komit yang dipilih tanpa melancarkan editor. Sebagai contoh, git commit
--amend --no-edit meminda komit tanpa mengubah mesej komitnya.

- amend
Gantikan hujung cawangan semasa dengan membuat komitmen baharu. Pokok yang direkodkan ialah
disediakan seperti biasa (termasuk kesan pilihan -i dan -o dan eksplisit
pathspec), dan mesej daripada komit asal digunakan sebagai titik permulaan,
bukannya mesej kosong, apabila tiada mesej lain ditentukan daripada baris arahan
melalui pilihan seperti -m, -F, -c, dsb. Komit baharu mempunyai ibu bapa dan pengarang yang sama
yang semasa (pilihan --reset-author boleh mengatasi ini).

Ia adalah persamaan kasar untuk:

$ git reset --soft HEAD^
$ ... lakukan sesuatu yang lain untuk menghasilkan pokok yang betul ...
$ git commit -c ORIG_HEAD

tetapi boleh digunakan untuk meminda komit gabungan.

Anda harus memahami implikasi menulis semula sejarah jika anda meminda komitmen itu
telah pun diterbitkan. (Lihat bahagian "PULIH DARI BASE SEMULA HULU" dalam git-
melunaskan semula(1).)

--tiada-pasca-tulis semula
Pintas cangkuk pasca tulis semula.

-i, --termasuk
Sebelum membuat komitmen daripada kandungan berperingkat setakat ini, peringkat kandungan laluan
diberikan pada baris arahan juga. Ini biasanya bukan yang anda mahukan melainkan anda mahu
menyimpulkan gabungan bercanggah.

-o, --sahaja
Buat komitmen dengan mengambil kandungan pokok kerja yang dikemas kini bagi laluan yang ditentukan
baris arahan, tidak menghiraukan sebarang kandungan yang telah dipentaskan untuk laluan lain.
Ini ialah mod operasi lalai bagi pergi melakukan jika ada laluan yang diberikan pada
baris arahan, dalam hal ini pilihan ini boleh ditinggalkan. Jika pilihan ini dinyatakan
Bersama-sama dengan - amend, maka tiada laluan perlu ditentukan, yang boleh digunakan untuk meminda
komit terakhir tanpa melakukan perubahan yang telah dipentaskan.

-u[ ], --untracked-files[= ]
Tunjukkan fail yang tidak dijejaki.

Parameter mod adalah pilihan (lalai kepada semua), dan digunakan untuk menentukan pengendalian
fail yang tidak dijejaki; apabila -u tidak digunakan, lalainya ialah biasa, iaitu menunjukkan tidak dijejaki
fail dan direktori.

Pilihan yang mungkin adalah:

· tidak - Tunjukkan tiada fail yang tidak dijejaki

· biasa - Menunjukkan fail dan direktori yang tidak dijejaki

· semua - Juga menunjukkan fail individu dalam direktori yang tidak dijejaki.

Lalai boleh ditukar menggunakan konfigurasi status.showUntrackedFiles
pembolehubah didokumenkan dalam git-config(1).

-v, --verbose
Tunjukkan perbezaan bersatu antara komit HEAD dan perkara yang akan dilakukan di bahagian bawah
templat mesej komit untuk membantu pengguna menerangkan komit dengan mengingatkan apa
perubahan yang dilakukan oleh komitmen. Ambil perhatian bahawa output perbezaan ini tidak mempunyai garisan awalan
bersama #. Perbezaan ini tidak akan menjadi sebahagian daripada mesej komit.

Jika dinyatakan dua kali, tunjukkan sebagai tambahan perbezaan bersatu antara perkara yang akan dilakukan
dan fail worktree, iaitu perubahan tidak berperingkat kepada fail yang dijejaki.

-q, --senyap
Sekat mesej ringkasan komit.

--lari kering
Jangan buat komitmen, tetapi tunjukkan senarai laluan yang perlu dilakukan, laluan dengan
perubahan setempat yang akan dibiarkan tanpa komitmen dan laluan yang tidak dijejaki.

--status
Sertakan output daripada git-status(1) dalam templat mesej komit apabila menggunakan an
editor untuk menyediakan mesej komit. Lalai kepada hidup, tetapi boleh digunakan untuk mengatasi
pembolehubah konfigurasi commit.status.

--tiada status
Jangan sertakan output daripada git-status(1) dalam templat mesej komit apabila menggunakan
editor untuk menyediakan mesej komit lalai.

-S[ ], --gpg-sign[= ]
GPG-sign commit. Argumen keyid adalah pilihan dan lalai kepada committer
identiti; jika dinyatakan, ia mesti melekat pada pilihan tanpa ruang.

--tanpa-gpg-tanda
Countermand commit.gpgSign pembolehubah konfigurasi yang ditetapkan untuk memaksa setiap satu
komited untuk ditandatangani.

--
Jangan tafsirkan sebarang hujah lagi sebagai pilihan.

...
Apabila fail diberikan pada baris arahan, arahan itu melakukan kandungan
dinamakan fail, tanpa merekodkan perubahan yang telah berperingkat. Kandungan fail ini
juga dipentaskan untuk komit seterusnya di atas apa yang telah dipentaskan sebelum ini.

TARIKH FORMATS

Pembolehubah persekitaran GIT_AUTHOR_DATE, GIT_COMMITTER_DATE dan pilihan --date
menyokong format tarikh berikut:

Format dalaman Git
Ia adalah , di mana ialah bilangan
saat sejak zaman UNIX. ialah offset positif atau negatif
daripada UTC. Contohnya CET (iaitu 2 jam lebih awal UTC) ialah +0200.

RFC 2822
Format e-mel standard seperti yang diterangkan oleh RFC 2822, contohnya Khamis, 07 Apr 2005
22:13:13 +0200.

ISO 8601
Masa dan tarikh yang ditentukan oleh piawaian ISO 8601, contohnya 2005-04-07T22:13:13. The
parser menerima ruang dan bukannya aksara T juga.

Nota
Selain itu, bahagian tarikh diterima dalam format berikut: YYYY.MM.DD,
MM/DD/YYYY dan DD.MM.YYYY.

CONTOH

Apabila merakam kerja anda sendiri, kandungan fail yang diubah suai dalam pokok kerja anda adalah
disimpan sementara ke kawasan pementasan yang dipanggil "indeks" dengan pergi menambah. Fail boleh
berbalik semula, hanya dalam indeks tetapi tidak dalam pokok kerja, kepada komit terakhir
dengan git reset HEAD -- , yang berkesan kembali pergi menambah dan menghalang perubahan
ke fail ini daripada mengambil bahagian dalam komit seterusnya. Selepas membina negeri untuk menjadi
dilakukan secara berperingkat dengan arahan ini, git commit (tanpa sebarang parameter nama laluan)
digunakan untuk merekodkan apa yang telah dipentaskan setakat ini. Ini adalah bentuk perintah yang paling asas.
Satu contoh:

$ edit hello.c
$ git rm selamat tinggal.c
$ git tambah hello.c
$ git commit

Daripada menyusun fail selepas setiap perubahan individu, anda boleh memberitahu git commit untuk melihat
perubahan pada fail yang kandungannya dijejaki dalam pokok kerja anda dan lakukan
git add dan git rm yang sepadan untuk anda. Iaitu, contoh ini melakukan perkara yang sama seperti
contoh terdahulu jika tiada perubahan lain dalam pokok kerja anda:

$ edit hello.c
$ rm selamat tinggal.c
$ git commit -a

Perintah git commit -a pertama kali melihat pokok kerja anda, perasan bahawa anda telah mengubah suai
hello.c dan keluarkan goodbye.c, dan melakukan git add dan git rm yang diperlukan untuk anda.

Selepas membuat perubahan kepada banyak fail, anda boleh mengubah susunan perubahan direkodkan,
dengan memberikan nama laluan kepada git commit. Apabila nama laluan diberikan, arahan membuat komit
yang hanya merekodkan perubahan yang dibuat pada laluan yang dinamakan:

$ edit hello.c hello.h
$ git tambah hello.c hello.h
$ edit Makefile
$ git commit Makefile

Ini membuat komitmen yang merekodkan pengubahsuaian kepada Makefile. Perubahan dipentaskan untuk
hello.c dan hello.h tidak termasuk dalam komit yang terhasil. Walau bagaimanapun, perubahan mereka adalah
tidak hilang - mereka masih dipentaskan dan hanya ditahan. Selepas urutan di atas, jika anda
lakukan:

$ git commit

komit kedua ini akan merekodkan perubahan kepada hello.c dan hello.h seperti yang dijangkakan.

Selepas penggabungan (dimulakan oleh pergi bergabung or pergi tarik) berhenti kerana konflik, bersih
laluan bercantum sudah berperingkat untuk dikomit untuk anda, dan laluan yang bercanggah adalah
dibiarkan dalam keadaan tidak bercantum. Anda perlu menyemak dahulu laluan mana yang bercanggah pergi
terkini dan selepas membetulkannya secara manual dalam pokok kerja anda, anda akan membuat keputusan sebagai
biasa dengan pergi menambah:

$ git status | grep tidak digabungkan
tidak bercantum: hello.c
$ edit hello.c
$ git tambah hello.c

Selepas menyelesaikan konflik dan membuat keputusan, git ls-files -u akan berhenti menyebut
jalan yang bercanggah. Apabila anda selesai, jalankan git commit untuk akhirnya merekodkan gabungan:

$ git commit

Seperti dalam kes untuk merekodkan perubahan anda sendiri, anda boleh menggunakan -pilihan untuk menyimpan penaipan. satu
perbezaannya ialah semasa resolusi gabungan, anda tidak boleh menggunakan git commit dengan nama laluan ke
ubah susunan perubahan dilakukan, kerana gabungan itu hendaklah direkodkan sebagai a
komitmen tunggal. Malah, arahan itu enggan dijalankan apabila diberi nama laluan (tetapi lihat -i
pilihan).

PERBINCANGAN

Walaupun tidak diperlukan, adalah idea yang baik untuk memulakan mesej komit dengan satu pendek
(kurang daripada 50 aksara) baris meringkaskan perubahan, diikuti dengan baris kosong dan kemudian a
penerangan yang lebih teliti. Teks sehingga baris kosong pertama dalam mesej komit ialah
dianggap sebagai tajuk komit, dan tajuk itu digunakan di seluruh Git. Sebagai contoh, git-
tampalan format(1) menukar komit menjadi e-mel, dan ia menggunakan tajuk pada baris Subjek dan
selebihnya komit dalam badan.

Git adalah sedikit sebanyak pengekodan aksara agnostik.

· Kandungan objek gumpalan adalah urutan bait yang tidak ditafsirkan. Tidak ada
terjemahan pengekodan pada peringkat teras.

· Nama laluan dikodkan dalam bentuk normalisasi UTF-8 C. Ini terpakai kepada objek pokok,
fail indeks, nama ref, serta nama laluan dalam argumen baris arahan,
pembolehubah persekitaran dan fail konfigurasi (.git/config (lihat git-config(1)), gitignore(5),
gitattribut(5) dan gitmodules(5)).

Ambil perhatian bahawa Git pada peringkat teras menganggap nama laluan hanya sebagai jujukan bukan NUL
bait, tiada penukaran pengekodan nama laluan (kecuali pada Mac dan Windows).
Oleh itu, menggunakan nama laluan bukan ASCII kebanyakannya akan berfungsi walaupun pada platform dan fail
sistem yang menggunakan pengekodan ASCII lanjutan warisan. Walau bagaimanapun, repositori dibuat pada
sistem sedemikian tidak akan berfungsi dengan betul pada sistem berasaskan UTF-8 (cth. Linux, Mac, Windows)
dan begitu juga sebaliknya. Selain itu, banyak alatan berasaskan Git hanya menganggap nama laluan adalah
UTF-8 dan akan gagal memaparkan pengekodan lain dengan betul.

· Mesej log komit biasanya dikodkan dalam UTF-8, tetapi pengekodan ASCII lanjutan lain
turut disokong. Ini termasuk ISO-8859-x, CP125x dan banyak lagi, tetapi tidak
Pengekodan berbilang bait UTF-16/32, EBCDIC dan CJK (GBK, Shift-JIS, Big5, EUC-x, CP9xx
dll).

Walaupun kami menggalakkan bahawa mesej log komit dikodkan dalam UTF-8, kedua-dua teras dan
Git Porcelain direka untuk tidak memaksa UTF-8 pada projek. Jika semua peserta a
projek tertentu mendapati ia lebih mudah untuk menggunakan pengekodan warisan, Git tidak melarang
ia. Walau bagaimanapun, terdapat beberapa perkara yang perlu diingat.

1. pergi melakukan and pergi commit-tree mengeluarkan amaran jika mesej log komit diberikan kepadanya
tidak kelihatan seperti rentetan UTF-8 yang sah, melainkan anda secara eksplisit mengatakan projek anda menggunakan a
pengekodan warisan. Cara untuk mengatakan ini adalah dengan mempunyai i18n.commitencoding dalam .git/config
fail, seperti ini:

[i18n]
commitencoding = ISO-8859-1

Komit objek yang dibuat dengan tetapan di atas merekodkan nilai i18n.commitencoding
dalam pengepala pengekodannya. Ini untuk membantu orang lain yang melihat mereka nanti. Kekurangan
pengepala ini membayangkan bahawa mesej log komit dikodkan dalam UTF-8.

2. pergi log, pergi Menunjukkan, pergi menyalahkan dan rakan melihat pengepala pengekodan komit
objek, dan cuba kod semula mesej log ke dalam UTF-8 melainkan dinyatakan sebaliknya. awak
boleh menentukan pengekodan output yang dikehendaki dengan i18n.logoutputencoding dalam .git/config
fail, seperti ini:

[i18n]
pengekodan logoutputen = ISO-8859-1

Jika anda tidak mempunyai pembolehubah konfigurasi ini, nilai i18n.commitencoding ialah
digunakan sebagai gantinya.

Ambil perhatian bahawa kami sengaja memilih untuk tidak mengekod semula mesej log komit apabila komit adalah
dibuat untuk memaksa UTF-8 pada tahap objek komit, kerana pengekodan semula kepada UTF-8 tidak
semestinya operasi boleh balik.

PERSEKITARAN DAN CONFIGURATION PELBAGAI

Editor yang digunakan untuk mengedit mesej log komit akan dipilih daripada GIT_EDITOR
pembolehubah persekitaran, pembolehubah konfigurasi core.editor, persekitaran VISUAL
pembolehubah, atau pembolehubah persekitaran EDITOR (dalam susunan itu). Lihat git-var(1) untuk butiran.

KEDAI

Perintah ini boleh menjalankan cangkuk commit-msg, prepare-commit-msg, pre-commit dan post-commit.
Lihat githooks(5) untuk maklumat lanjut.

Gunakan git-commit dalam talian menggunakan perkhidmatan onworks.net