Git

繁體中文 ▾ Topics ▾ Latest version ▾ git-init last updated in 2.52.0

名稱

git-init -創建一個空的Git倉儲或是重新初始化已存在的倉儲

格式

git init [-q | --quiet] [--bare] [--template=<模板目錄>]
	 [--separate-git-dir <git 目錄>] [--object-format=<格式>]
	 [-b <分支名稱> | --initial-branch=<分支名稱>]
	 [--shared[=<權限>]] [目錄]

說明

這行指令會創建一個空的Git倉儲,基本上是一個名為`.git`的目錄,含有`objects`,refs/heads,`refs/tags`這幾個子目錄,其他模板檔案,跟一個指向`master`分支Head的初始`HEAD`檔案。

如果有設定環境變數`$GIT_DIR`,則會使用被指定的路徑,而不是`./.git`來建立倉儲的基礎檔案。

如果object儲存路徑有經由環境變數`$GIT_OBJECT_DIRECTORY`所指定,則SHA-1的目錄將會被設置在其底下,否則會使用預設的`$GIT_DIR/objects`目錄。

在現有的倉儲執行’git init’是很安全的。它並不會覆蓋掉已存在的檔案。重新執行’git init’最主要的原因,是去取得新增的模板檔案(或是加上 --separate-git-dir 將倉儲移到另一個位置)。

選項

-q
--quiet: 只會印出錯誤和警告訊息;其他輸出訊息皆會被遮蔽。
--bare: 創建一個裸倉儲。如果環境變數`GIT_DIR`未被設定 ,則會設置在當前作業目錄下。
--object-format=<格式>: 指定倉庫的物件格式(雜湊演算法)。可以指定為’sha1’或是’sha256'(有啟用的話)。預設值為’sha1'。

Warning

Missing zh_HANT/object-format-disclaimer.txt

See original version for this content.

--template=<template_directory>

指定用於取得模板檔案的目錄(請參考下面的"模板檔案目錄"章節。)

--separate-git-dir=<git dir>

不使用`$GIT_DIR`或是`./.git/`作為初始化倉儲的路徑,而是創建一個儲存實際倉儲路徑的檔案。這個檔案會作為資料系統獨立的Git捷徑,連結到倉儲。

如果重新初始化,倉儲則會被移到指定的路徑。

-b <branch-name>

--initial-branch=<分支名稱>

為新創的倉儲指定初始分支的名稱。若沒有指定,就會退而使用預設名稱’master'。

指定的Git倉儲可在多個使用者之間共享,這會允許屬於相同群組的使用者對這個倉儲推送。指定時,組態參數"core.sharedRepository"將會被設定,讓在`$GIT_DIR`底下的檔案和目錄使用指定的權限來創建。當沒有指定時,Git會使用umask(2)所回報的權限。

這個選項可以加上下列數值,若不給值,則預設會使用’group':

umask (或是 false): 使用umask(2)回報的權限。也是當沒有指定`--shared`時的預設值。
group (或是 true): 讓倉儲變成群組可寫入(還有g+sx,因為git群組可能並非所有使用者的主群組)。這用於放寬原本較為安全的umask(2)權限。請注意,umask仍然會適用於其他權限(舉例來說, 當umask是'0022’時,使用’group’並不會移除其他使用者(non-group)的讀取權限。請參閱'0xxx’來知道如何精確指定倉庫的權限。
all (或 world 或是 everybody): 跟’group’大致相同,但會使倉庫可被所有使用者讀取。
0xxx: 0xxx 是個八進位數字,而各個檔案都會擁有權限'0xxx'。'0xxx’會覆蓋掉使用者的umask(2)值(而且並不像group跟all一樣會放寬權限)。'0640’會創建群組可讀,但群組不可寫,其他人也不可存取的倉儲。'0660’會創建當前使用者與群組可讀可寫,但是其他人無法存取的倉儲。

在預設中,共享倉庫的設定旗標 receive.denyNonFastForwards是被啟用的,所以你無法強制使用非快進進行推送。

如果你在指令中提供了’目錄',而此目錄不存在的話,它則會被創建。

模版檔案目錄

並非以點作為名稱開頭的檔案和目錄將會在`$GIT_DIR`被創建後,被複製到其中。

模板目錄將為下列其一(依照順序):

在選項`--template`中被給予的引數;
環境變數`$GIT_TEMPLATE_DIR`中的內容;
設定變數`init.templateDir`; 或是
預設模板目錄:/usr/share/git-core/templates。

The default template directory includes some directory structure, suggested "exclude patterns" (see gitignore[5]), and sample hook files.

The sample hooks are all disabled by default. To enable one of the sample hooks rename it by removing its .sample suffix.

See githooks[5] for more general info on hook execution.

範例

Start a new Git repository for an existing code base

$ cd /path/to/my/codebase
$ git init (1)
$ git add . (2)
$ git commit (3)

Create a /path/to/my/codebase/.git directory.
Add all existing files to the index.
Record the pristine state as the first commit in the history.

Part of the git[1] suite

Setup and Config

Getting and Creating Projects

Basic Snapshotting

Branching and Merging

Sharing and Updating Projects

Inspection and Comparison

Patching

Debugging

Email

External Systems

Server Admin

Guides

Administration

Plumbing Commands

名稱

格式

說明

選項

模版檔案目錄

範例

GIT