.gitignore files contain a list of files Git should ignore in a local project. A .gitignore file commonly appears in the main directory of a project. You can ignore single files, multiple files, or folders.<\/p>\n\n\n\n
You may have files that you do not want to include in the main version of your Git repository<\/a>. These files may contain configurations or local variables that are private and should not be seen by other collaborators. <\/p>\n\n\n\n That\u2019s where the .gitignore file comes in. This file allows you to instruct Git to ignore files. <\/p>\n\n\n\n In this guide, we\u2019re going to talk about what .gitignore is, how it works, and how you can write your own .gitignore file. Without further ado, let\u2019s get started!<\/p>\n\n\n\n A .gitignore file lists the files which Git will ignore. .gitignore files usually appear in the root directory of a project. Files tracked by Git are not ignored unless you remove them from a project.<\/p>\n\n\n\n Git when you add them to a commit. This means that every file, including configuration files and compiled code, will be added to a commit if you use the * operator. This operator stages all files into a commit. <\/p>\n\n\n\n Often, developers want to ignore output folders, hidden system files, and compiled code. For instance, if you have a .env file in a repository, you may want to hide it. This is because .env files usually contain API keys which you may not want to commit to a repository. <\/p>\n\n\n\n There is no ignore command you can use to ignore files. You need to make a list of all the files that you want to ignore in the .gitignore file.<\/p>\n\n\n\n Creating a .gitignore<\/em> file is simple. Open up a command shell and create a text file called .gitignore<\/em> in the root directory of a project. You can do this using the touch command: <\/p>\n\n\n\n We’ve created a .gitignore file. We do not need to set up our file with any configuration settings. Our next step is to add a list of the files we want to ignore. These files become untracked files, which is another word to describe a file ignored Git in a local repository. <\/p>\n\n\n\n Consider the following .gitignore<\/em> file: <\/p>\n\n\n\n This file ignores two resources: all files in the node_modules directory and the .env file. We’ve ignored two specific resources in our local repository: a folder and a file. <\/p>\n\n\n\n This is a common setup with JavaScript projects. node_modules contains the local copy of all the dependencies you are using for a project. It would be impractical to commit this to a repository when you can just install these dependencies yourself. The .env file contains API keys. It is bad practice to share API keys in a repository to which many people have access. <\/p>\n\n\n\n Let\u2019s say that we want to ignore multiple files or directories. We can do this by using the * wildcard. <\/p>\n\n\n\n Let\u2019s ignore all .pyc files in a repository:<\/p>\n\n\n\n All files whose name patterns match *.pyc are ignored. The asterisk is the wildcard operator.<\/p>\n\n\n\n GitHub has created an excellent collection of gitignore files that you can use on their site. View GitHub\u2019s collection of gitignore files<\/a>.<\/p>\n\n\n\n You can use multiple .gitignore files in the same repository. This works because .gitignore is relative to the directory in which it is placed. <\/p>\n\n\n\n In our last example, we placed .gitignore in the root directory of our project. Let\u2019s say that we want to ignore all the files that end in .pyc in the diff\/ folder. We could do this by creating a file called .gitignore in the diff folder using the command line: <\/p>\n\n\n\n We would add the following rule to the .gitignore file:<\/p>\n\n\n\n When we go to commit code to our repository, Git will ignore any file in the diff\/ folder which ends in .pyc. <\/p>\n\n\n\n This setup is best when you only need rules to apply to certain folders within a project. However, it can be confusing to have multiple .gitignore files in one project. An alternative is to be more specific when you state which files your project should ignore. If you are specific, you can keep all your rules in one .gitignore file. Consider this file: <\/p>\n\n\n\n This .gitignore is in the root directory of a Git project. It instructs Git to ignore all files ending in .txt in the project. It also instructs Git to ignore all files ending in .pyc which are in the diff\/ folder.<\/p>\n\n\n\n It can be time-consuming to define a .gitignore file for every project you create. What\u2019s more, you\u2019ll usually find that most of your projects use the same set of .gitignore rules. <\/p>\n\n\n\n You can set a global git ignore rule which will automatically set the gitignore rules for every repository on your system. This file is usually placed in your home directory of your operating system, such as \/home\/your_username<\/em> or \/Users\/your_username<\/em>. <\/p>\n\n\n\n Let\u2019s create a global .gitignore file: <\/p>\n\n\n\n This command creates an empty .gitignore file in our home directory. Open up this file and add in whatever rules you want to set for all the Git repositories on your system. <\/p>\n\n\n\n Once you have configured your gitignore file, you can enforce its rules using the core.excludesFile<\/em> property: <\/p>\n\n\n\n This command sets the rules in the ~\/.gitignore<\/em> file to apply to all Git repositories on a computer. <\/p>\n\n\n\n Be careful when you are defining a global git ignore rule. This is because the rules in a global .gitignore are set by default across all projects. <\/p>\n\n\n\n A global .gitignore file is best used for common files like .env which you will almost never want to commit to a git repository.<\/p>\n\n\n\n You cannot always anticipate which files you will want to ignore in a project. It may be the case that you have previously committed a file to a repository but now you want to ignore it. <\/p>\n\n\n\n Let\u2019s ignore the file config.json. <\/em>This file is already committed to our repository. We should start by adding an ignore rule to our .gitignore<\/em> file: <\/p>\n\n\n\n This command appends config.json<\/em> to the end of our .gitignore file. Now we have to remove the file from our repository. We can do this using the git rm \u2013cached command. This command will only remove a file from your repository. It will remain a local file on your computer. <\/p>\n\n\n\n Next time we create a commit, the config.json file will be ignored.<\/p>\n\n\n\n You can commit a file that has been ignored in your .gitignore file. <\/p>\n\n\n\n This may be useful if you are creating default config files that you want to commit to a repository that would otherwise be ignored. You can commit an ignored file using the -f flag when you are adding a file to the staging area: <\/p>\n\n\n\n This code adds the file config.json to the staging area. It then creates a commit based on the contents of the staging area. You can learn more about the git add in our git add tutorial<\/a>. You can read about the git commit command in our git commit tutorial<\/a>.<\/p>\n\n\n\n The .gitignore file allows you to ignore files in a Git repository. <\/p>\n\n\n\n You may not want to include all the files in your local copy of a project in your commits. For instance, you may not want to commit compiled code, or system logs, or config files. To ignore files, you can specify which ones you want to ignore in .gitignore. <\/p>\n\n\n\n A project can contain multiple .gitignore<\/em> files. You can override a .gitignore rule using the -f flag when you use the git add command. <\/p>\n\n\n\n Now you\u2019re ready to use the .gitignore file like an expert! <\/p>\n","protected":false},"excerpt":{"rendered":".gitignore files contain a list of files Git should ignore in a local project. A .gitignore file commonly appears in the main directory of a project. You can ignore single files, multiple files, or folders. You may have files that you do not want to include in the main version of your Git repository. These…","protected":false},"author":240,"featured_media":19773,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[17286],"tags":[],"class_list":{"0":"post-19682","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-git"},"acf":{"post_sub_title":"","sprint_id":"","query_class":"Git","school_sft":"","parent_sft":"","school_privacy_policy":"","has_review":null,"is_sponser_post":"","is_guest_post":""},"yoast_head":"\nWhat is a .gitignore File?<\/h2>\n\n\n\n
How to Write a .gitignore File<\/h2>\n\n\n\n
touch .gitignore<\/pre><\/div>\n\n\n\n
node_modules\/\n.env\n<\/pre><\/div>\n\n\n\n
*.pyc<\/pre><\/div>\n\n\n\n
Using Multiple .gitignore Files<\/h2>\n\n\n\n
touch diff\/.gitignore<\/pre><\/div>\n\n\n\n
*.pyc<\/pre><\/div>\n\n\n\n
*.txt\ndiff\/*.pyc<\/pre><\/div>\n\n\n\n
How to Create a Global Git Ignore Rule<\/h2>\n\n\n\n
touch ~\/.gitignore<\/pre><\/div>\n\n\n\n
git config --global core.excludesFile ~\/.gitignore<\/pre><\/div>\n\n\n\n
How to Ignore a Committed File<\/h2>\n\n\n\n
echo config.json >> .gitignore<\/pre><\/div>\n\n\n\n
git rm --cached config.json<\/pre><\/div>\n\n\n\n
How to Commit an Ignored File<\/h2>\n\n\n\n
git add -f config.json\ngit commit -m "feat: Create default config file"<\/pre><\/div>\n\n\n\n
Conclusion<\/h2>\n\n\n\n