1400

I need to add some rules to my .gitignore file. However, I can't find it in my project folder. Isn't it created automatically by Xcode? If not, what command allows me to create one?

9
  • 68
    echo 'xxx' > .gitignore
    – ybdesire
    Jun 26, 2015 at 5:26
  • 12
    gitignore.io Jul 12, 2016 at 15:19
  • 13
    Copy the .gitignore file from one of your existing projects.
    – Suragch
    Feb 5, 2017 at 22:25
  • how about migrating the question to superuser?
    – Makan
    Aug 3, 2017 at 7:50
  • So they fixed this apparently! Feb 24, 2019 at 2:49

42 Answers 42

1811

If you're using Windows, it will not let you create a file without a filename in Windows Explorer. It will give you the error "You must type a file name" if you try to rename a text file as .gitignore

Enter image description here

To get around this, I used the following steps.

  1. Create the text file gitignore.txt
  2. Open it in a text editor and add your rules, then save and close
  3. Hold Shift, right click the folder you're in, and then select Open command window here
  4. Then rename the file in the command line, with ren gitignore.txt .gitignore

Alternatively, HenningCash suggests in the comments:

You can get around this Windows Explorer error by appending a dot to the filename without an extension: .gitignore.. It will be automatically changed to .gitignore.

19
  • 32
    To do this on a mac, simply CD to the project directory and "touch .gitignore" you will have to also make sure you can see hidden files
    – Jameo
    Dec 17, 2012 at 21:37
  • 7
    After creating the gitignore.txt file "ren" did not work for me. However I just opened the Git Bash on the directory and was able to use the linux "mv" command like normal.
    – gwgeller
    Feb 22, 2013 at 16:46
  • 528
    You can get around this Windows Explorer error by appending a dot to the filename without extension: .gitignore. will be automatically changed to .gitignore (Win7 x64) May 10, 2013 at 12:11
  • 44
    Funny thing that the OP is using XCode which means he's running OS X. And ya all upvoting an answer targeted on Windows?!! Sep 9, 2014 at 13:51
  • 23
    Its funny how google disagrees, a google search ".gitignore on windows" leads to this page as a first result :)
    – Ateik
    Feb 2, 2016 at 13:35
626

As simple as things can (sometimes) be: Just add the following into your preferred command-line interface (GNU Bash, Git Bash, etc.)

touch .gitignore

As War pointed out in the comments, touch works on Windows as well as long as you provide the full path. This might also explain why it does not work for some users on Windows: The touch command seems to not be in the $PATH on some Windows versions by default.

C:\> "c:\program files (x86)\git\bin\touch.exe" .gitignore

Note: The path might differ, depending on your setup and installation path.

11
  • 8
    this didn't work for me, it said touch isn't a program
    – Jim Jones
    Jul 22, 2014 at 4:49
  • 3
    I just tried it both in cmd and powershell in Windows 7 without a problem. Then tried it again on the 8.1 machine of a colleague and can confirm that (the Cmdlet isn't present). You will have to search up the problem for that as this will bite you anyway with other things as well. In short: I'm sorry for you :/
    – kaiser
    Aug 11, 2014 at 16:55
  • 2
    fyi - Windows does not have a native touch command. The closest equivalent in Windows is "copy /b filename.ext +,," (where filename.ext is your file's name). The +,, is a special flag to copy telling it to simply update the date/time on the file. superuser.com/questions/10426/… Oct 7, 2014 at 15:19
  • 8
    @SpencerKillen you need to use this command by using git bash. Jan 8, 2015 at 16:47
  • 2
    Works in command line if you specify the full path for touch ... C:\> "c:\program files (x86)\git\bin\touch.exe" .gitignore
    – War
    Jun 20, 2015 at 16:40
331

The easiest way to create the .gitignore file in Windows Explorer is to create a new file named .gitignore..

This will skip the validation of having a file extension, since it actually has an empty file extension.

8
  • 12
    Definitely the easiest way, if you want to stay in pure Windows style. . .
    – Raj
    Jan 21, 2014 at 4:59
  • 5
    This, is the best way for the laziest among us :D Mar 18, 2014 at 21:29
  • 6
    This worked great for me. Windows actually removed the last . so the file name was changed to just .gitignore when I saved the change.
    – JoBaxter
    Feb 23, 2015 at 16:58
  • 4
    This is the real answer to what appears to be a bug in windows explorer... although I assume the original question is osx
    – Greg Woods
    May 8, 2015 at 13:45
  • if you move your project to linux system for example it will keep the dot at the end of the file, for me this is not a good method, always stick with the standard naming conventions, everyone who asks how to make a .gitignore has the skill to open a text-editor and create a .gitignore file without extra risky hacks.
    – vdegenne
    Jan 12, 2017 at 5:28
214

The .gitignore file is not added to a repository by default. Use vi or your favorite text editor to create the .gitignore file then issue a git add .gitignore followed by git commit -m "message" .gitignore. The following commands will take care of it.

> .gitignore
git add .gitignore
git commit -m "message" .gitignore
5
  • 6
    Hi, thanx for your reply :), actually, i have created a .gitignore file, but when performing this command line: git add .gitignore, i got this message: fatal: pathspec '.gitignore' did not match any files , although, i make sure the .gitignore file does exist on my project folder, am i wrong ?
    – Luca
    May 24, 2012 at 20:04
  • If git says the file doesn't exist - the file you've created has a different name. you can see all files in a folder with ls -la. Add to the question what you did (details) if you're still struggling
    – AD7six
    May 24, 2012 at 20:28
  • My .gitignore file was existing already. I just added a rule to ignore eclipse.prefs and .log files Committed it. Will it start working immediately?
    – R11G
    Sep 12, 2013 at 7:40
  • Very helpful. Also, this method works similarly with renaming folders/directories too (not just files). For instance Z:\pristine-vagrant>ren "New folder" .ssh Feb 19, 2014 at 4:41
  • In case of 'fatal: pathspec..' error, I simply ran git fetch then tried again git commit and push. It worked. Jun 11, 2019 at 10:29
158

In Windows

  1. Open Notepad.
  2. Add the contents of your gitignore file.
  3. Click "Save as" and select "all files".
  4. Save as .gitignore

Easy peasy! No command line required!

1
  • 20
    NotePad++ is happy with this also for those that use it.
    – Liam
    Dec 19, 2014 at 14:43
60

macOS and Linux one-liner

An easy way to get a default Git ignore without messing about with create/copy/paste is to use the curl command from the terminal. First cd into your projects root directory and then run the command by replacing MY_API_NAME with your API name from one of the following two sources:

gitignore.io

curl -o .gitignore https://www.toptal.com/developers/gitignore/api/MY_API_NAME

You can find your API name by searching from the list here and clicking Generate.

Java Example:

curl -o .gitignore https://www.toptal.com/developers/gitignore/api/java

GitHub

Alternatively, you can use the ones at GitHub. Find the filename for your API here.

curl -o .gitignore https://raw.githubusercontent.com/github/gitignore/master/MY_API_NAME.gitignore

Java Example:

curl -o .gitignore https://raw.githubusercontent.com/github/gitignore/master/Java.gitignore

Windows

Here are some similar alternatives for Windows.

But honestly setting that up looks like more trouble that it is worth. If I had Windows then I would just create an empty file called .gitignore in my project's root folder and then copy and paste the default text from gitignore.io or GitHub.

1
  • Awesome! Just what I were looking for. I recommend ConEmu that is a window terminal that support curl. conemu.github.io Apr 15, 2021 at 13:51
58

On Windows, you can use cmd:

echo "" >.gitignore

Or use Git Bash cmd:

touch .gitignore,

This useful for a Linux and Mac system.

3
  • echo > .gitignore works well. To continue to append the files to ignore, we can do echo "*.obj" >> .gitignore
    – ozkary
    Nov 13, 2016 at 16:38
  • I would be careful about using this approach. On my computer, running Windows 10, using echo to create .gitignore resulted in a UTF 16LE formatted file, which Git apparently did not parse correctly. Creating the file through Windows Explorer resulted in an ANSI formatted file, which worked correctly with Git.
    – jlspublic
    Jun 19, 2018 at 2:30
  • This one should be the accepted answer Nov 19, 2021 at 13:14
52

I want my contribution as well. This time, animated one :)

Vim (mini tutorial):

i   - start editing
ESC - get back to normal mode
:w  - save
:q  - quit

Enter image description here

0
45

Using the Git Bash console.

  • Navigate to your project
  • Type "touch .gitignore"

The .gitignore file will be created for you.

Enter image description here

35

My contribution is aimed at those on a Mac, and it can be applied to not only those working on an iOS project (as implied by the question mentioning Xcode), but any type of project.



The easy way that I do it is to go into the terminal and run vim .gitignore and then add the files. Usually you can just copy what you need from one of the templates on GitHub at https://github.com/github/gitignore.


Step 1
While in your project, type the following command

vim .gitignore

Enter image description here



Step 2
You now have your file open with Vim.

Enter image description here

Press i to insert text. You will see that the file is ready when you see the --INSERT-- at the bottom.

Enter image description here



Step 3 (option 1)
For Objective-C projects, you can copy from https://raw.githubusercontent.com/github/gitignore/master/Objective-C.gitignore and paste it into your .gitignore file:

Enter image description here

Press Esc, type in :wq, and press Return. Which saves the file.



Step 3 (option 2)
Add whatever files apply to your project.

If you are not sure what to add, the best keywords to use in your search engine would be to include your project type and text editor. For example, if you use Sublime Text you would want to add

*.sublime-workspace

And if you are working with a Cordova project in Dreamweaver you would want to add

_notes
dwsync.xml
32

Here a nice tip under Windows:

  • Right click in Windows Explorer, New > Text Document
  • Name it .gitignore. (with a trailing dot - that is the tip)
  • You end up with a .gitignore file :)

Tested under Windows 7 and 8.

This tip assumes that your Windows Explorer displays the file extensions.

Windows Explorer .gitignore

1
18

Create a .gitignore file in include all files and directories that you don't want to commit.

Example:

#################
## Eclipse
#################

*.pydevproject
.project
.metadata
.gradle
bin/
tmp/
target/
*.tmp
*.bak
*.swp
*~.nib
local.properties
.classpath
.settings/
.loadpath

# External tool builders
.externalToolBuilders/

# Locally stored "Eclipse launch configurations"
*.launch

# CDT-specific
.cproject

# PDT-specific
.buildpath


#################
## Visual Studio
#################

## Ignore Visual Studio temporary files, build results, and
## files generated by popular Visual Studio add-ons.

# User-specific files
*.suo
*.user
*.sln.docstates

# Build results

[Dd]ebug/
[Rr]elease/
x64/
build/
[Bb]in/
[Oo]bj/

# MSTest test Results
[Tt]est[Rr]esult*/
[Bb]uild[Ll]og.*

*_i.c
*_p.c
*.ilk
*.meta
*.obj
*.pch
*.pdb
*.pgc
*.pgd
*.rsp
*.sbr
*.tlb
*.tli
*.tlh
*.tmp
*.tmp_proj
*.log
*.vspscc
*.vssscc
.builds
*.pidb
*.log
*.scc

# Visual C++ cache files
ipch/
*.aps
*.ncb
*.opensdf
*.sdf
*.cachefile

# Visual Studio profiler
*.psess
*.vsp
*.vspx

# Guidance Automation Toolkit
*.gpState

# ReSharper is a .NET coding add-in
_ReSharper*/
*.[Rr]e[Ss]harper

# TeamCity is a build add-in
_TeamCity*

# DotCover is a Code Coverage Tool
*.dotCover

# NCrunch
*.ncrunch*
.*crunch*.local.xml

# Installshield output folder
[Ee]xpress/

# DocProject is a documentation generator add-in
DocProject/buildhelp/
DocProject/Help/*.HxT
DocProject/Help/*.HxC
DocProject/Help/*.hhc
DocProject/Help/*.hhk
DocProject/Help/*.hhp
DocProject/Help/Html2
DocProject/Help/html

# Click-Once directory
publish/

# Publish Web Output
*.Publish.xml
*.pubxml

# NuGet Packages Directory
## TODO: If you have NuGet Package Restore enabled, uncomment the next line
#packages/

# Windows Azure Build Output
csx
*.build.csdef

# Windows Store app package directory
AppPackages/

# Others
sql/
*.Cache
ClientBin/
[Ss]tyle[Cc]op.*
~$*
*~
*.dbmdl
*.[Pp]ublish.xml
*.pfx
*.publishsettings
1
  • 2
    This doesn't answer the question. The question was about how to create the file, not about the content of the file. Jun 17, 2022 at 17:51
16

http://gitignore.io is an open source utility that can help you create useful .gitignore files for your project. There is also a command line API that you can access via a gi command: http://gitignore.io/cli

  1. Install gi command for OS X:

    $ echo "function gi() { curl http://gitignore.io/api/\$@ ;}" >> ~/.bash_profile && source ~/.bash_profile

  2. View .gitignore file contents (Output: http://gitignore.io/api/xcode,osx):

    $ gi xcode,osx

  3. You should see output on the terminal, if you want to append the results to a new .gitignore file.

    $ gi xcode,osx >> .gitignore

16

I have another simple idea.

Let's use the echo command in cmd,

echo ./idea > .gitignore

This will create the .gitignore file having text content "./idea".

You may now manually change data from the file using a text editor.

Or simply

Console:

echo .gitignore notepad.exe

to instantly edit gitignore.

If you don’t know which files are should be gitignored for your IDE or operating system just go to www.gitignore.io.

gitignore.io - here it will generate the gitignore commands or text for you. Just say your API or OS. That’s it!. Just copy and paste into your file. Simple!

15

You can go to Create Useful .gitignore Files For Your Project.

Select the IDE, operating systems or programming language. It will automatically generate one for you.

Enter image description here

1
  • This has already been covered in several previous answers. Jun 17, 2022 at 21:35
14

Here's my personal favorite, http://help.github.com/ignore-files/

Also just in case you wanted to ignore Xcode files, refer to an answer to Git ignore file for Xcode projects.

1
  • You ought to put the essential information in your answer, so it is not all reliant on the link not breaking. Aug 4, 2019 at 17:44
12

In Windows, open a DOS prompt (cmd) window, and use this command line:

type > .gitignore
10

The following works in PowerShell and a command prompt (CMD):

echo '*.ignore_me' > .gitignore

I ran into a weird issue where Git effectively wouldn't read the .gitignore file. I then deleted the .gitignore file and created one using Vim which worked fine.

To add additional files to ignore, just call the following command:

echo 'another_file_to_ignore' >> .gitignore

It will append further files to the existing .gitignore file.

1
  • 2
    I had the same weird issue. Turns out to be the encoding, so be sure to save the file as utf-8.
    – aw04
    Sep 16, 2015 at 15:44
10

If you don't want to have your .gitignore file interfere with anyone else's repository, you can also use .git/info/exclude (see http://help.github.com/ignore-files/).

10

A few ways to create file .gitignore using cmd:

With the copy con command:

  1. open cmd and type cd to your Git repository

  2. Type copy con .gitignore and press Ctrl + Z.

    Enter image description here

With the start notepad .gitignore command

  1. Open cmd and type cd to your Git repository

  2. Type start notepad .gitignore and press the Yes button in the opened Notepad dialog box.

    Enter image description here

With the edit .gitignore command (Windows x86 only)

  1. Open cmd and type cd to your Git repository
  2. Type edit .gitignore and close the opened 'edit' editor.
10

Windows

Enter image description here

File name: ".gitignore",
Save as type: All Files (.)

9
  1. To create a .gitignore file, you just create a .txt file and change the extension as in the following:

Enter image description here

Then you have to change the name, writing the following line on the cmd:

 rename git.txt .gitignore

where git.txt is the name of the file you've just created.

Then you can open the file and write all the files you don’t want to add on the repository. For example, mine looks like this:

# OS junk files
[Tt]humbs.db
*.DS_Store

# Visual Studio files
*.[Oo]bj
*.user
*.aps
*.pch
*.vspscc
*.vssscc
*_i.c
*_p.c
*.ncb
*.suo
*.tlb
*.tlh
*.bak
*.[Cc]ache
*.ilk
*.log
*.lib
*.sbr
*.sdf
*.pyc
*.xml
ipch/
obj/
[Bb]in
[Dd]ebug*/
[Rr]elease*/
Ankh.NoLoad

# Tooling
_ReSharper*/
*.resharper
[Tt]est[Rr]esult*

# Project files
[Bb]uild/

# Subversion files
.svn

# Office Temp Files
~$*

Once you have this, you need to add it to your Git repository. You have to save the file where your repository is.

Then in your Git Bash, you have to write the following line:

Enter image description here

If the repository already exists, you have to do the following:

  1. git rm -r --cached .
  2. git add .
  3. git commit -m ".gitignore is now working"

If step 2 doesn’t work then you should write the whole route of the files that you would like to add.

1
  • Finally an answer that shows what syntax is used within the .gitignore file.
    – Resource
    Oct 26 at 11:05
9

Do:

  1. Open a Git terminal
  2. Go to the Git repository of the project
  3. Create a .gitignore file by touch .gitignore command
  4. Use git add .gitignore command to add the ignore file
  5. Set ignore rules in the ignore file
  6. Run the command cat .gitignore

By running the command in step 3, you will get the .gitignore file in the project directory.

9

You can directly create an empty .gitignore file. Open cmd in the location you need to add this file to, and type this command:

copy con .gitignore

Press Enter. We are now in edit mode of the newly created file, but we do not need to add anything now. Just press F6 and then press Enter.

Now you have an empty .gitignore file. Edit your file in whatever editor you have.

3
  • 1
    copy nul .gitignore is better Aug 4, 2019 at 18:00
  • yes it does the work faster, thank you for the info. Aug 31, 2019 at 19:45
  • 1
    You can create .gitignore file in notepad by using ".gitignore" as file name when saving the file and notice the "" , notepad will then take the whole string between the quotation to save your file as the selected name Sep 20, 2019 at 9:36
8

To add .gitignore file to your not application you can use the

> npx add-gitignore

Now you can type "node" and use user space bar to choose it and Enter. That will add the node .gitignore to the project.

enter image description here

2
8

Windows:

On the command line:

.>.gitignore

This will show an error, but it will work.

3
  • What error will it show? Please respond by editing (changing) your answer, not here in comments (without "Edit:", "Update:", or similar - the answer should appear as if it was written today). Jun 17, 2022 at 21:15
  • An explanation would be in order. E.g., what is the first dot in the command line for? Standard input? What does it mean? How does it work? From the Help Center: "...always explain why the solution you're presenting is appropriate and how it works". Please respond by editing (changing) your answer, not here in comments (without "Edit:", "Update:", or similar - the answer should appear as if it was written today). Jun 17, 2022 at 21:16
  • Wish there was a way to ignore this git.
    – Resource
    Oct 26 at 11:03
6

Without using the command line (on Windows)

  1. Open any texteditor (e.g. Notepad) and add your rules.
  2. Click menu FileSave As
  3. Save it as ".gitignore" (include the quotations)
1
  • What text editor exactly? Do you mean "Text Editor" (repackaged gedit)? What platform (operating system and edition), incl. versions, was this tried on? Please respond by editing (changing) your answer, not here in comments (without "Edit:", "Update:", or similar - the answer should appear as if it was written today). Jun 17, 2022 at 18:52
4

To add any file in Xcode, go to the menu and navigate to menu FileNewFile...

For a .gitignore file choose OtherEmpty and click on Next. Type in the name (.gitignore) into the Save As field and click Create.

For files starting with a dot (".") a warning message will pop up, telling you that the file will be hidden. Just click on Use "." to proceed...

That's all.

To fill your brand new .gitignore you can find an example for ignoring Xcode file here: Git ignore file for Xcode projects

4

If you use Sublime Text as your IDE, you can create a new file and save it as .gitignore. Simply using Ctrl + N for the new file, and Ctrl + S to save as ".gitignore".

4

At work we are on Windows XP, and typing a period at the end of a filename doesn't work. A quick and easy way to create a .gitignore file without having the "You must type a filename"error is:

  1. open a cmd window and type "edit .gitignore".
  2. type "Alt (selects file menu), F, S. You now have an empty .gitignore file wherever your cmd prompt is pointing.

You can now populate it with your favorite text editor.

Not the answer you're looking for? Browse other questions tagged or ask your own question.