When working with any set of files, whether it is for programming, document writing, or otherwise, you may notice all sorts of extra files appear from time to time in your working directory, or you may need to temporarily create additional files for some specific purpose. Sometimes these are temporary auto-save files, ghost files created by your operating system, build files, log files, etc. And you don’t want these files getting mixed up with your critical project files. The easiest way to remove these extra files is to never bring them into Git in the first place. For this, you can use an “excludes” or “gitignore” file. But if these files are already created and you want to systematically remove them, Git clean is a great way to do it.
Git clean will literally clean your Git project, removing any files in your working directory that are not being tracked by Git. This means files you have added to Git will remain untouched but any additional files will be deleted. Of course, this command can be destructive, so this article will show you how to use the command safely and avoid any unintended data loss.
- Useful Options
- Your First Clean
- Git Clean Dry Run
- Interactively Select Files
- Clean a Specific Directory
Useful Options
The following list of options is not exhaustive, but provides some helpful tweaks that may be useful in getting you the desired action:
-n, --dry-run- Dry run, show a list of files that would be removed but do not remove them.
-i,--interactive- Proceed with file deletion interactively. Go through each file individually and approve of deletions file by file.
-X- The
-Xoption will only delete files ignored by Git. This is a good way to keep any files you may have created manually. If you’re unsure what “ignored by Git” means check out our full guide on -d- By default, Git clean will not delete files from untracked directories. The
-doption will tell Git clean to apply recursively into untrack directories. (Note: this option can be nullified by providing a<path>to the command.
Your First Clean
The first time you run the git clean command you may trigger an error:
fatal: clean.requireForce defaults to true and neither -i, -n, nor -f given; refusing to clean
This means that your Git configuration has the “force” requirement set to true. In effect, this means you must use a force -f option to run a Git clean or update your configuration.
You can go ahead and use the force option to proceed with the clean:
git clean -f
Or, you can use the -i (interactive) or -n (dry run) options. (More on these options below.)
Alternatively, you can update your Git configuration file to set the force requirement to false:
[clean] requireForce = false
With the above variable you will be able to run git clean without triggering an error.
Git Clean Dry Run
Before you attempt to clean anything you might to a “dry” run, or test, just to see what would be cleaned if you were to proceed with the command.
git clean -n
And you would get an output similar to the one below:
chris@server: /tmp/git-clean-test$ git clean -n Would remove garbage-file
The line “Would remove garbage-file” indicates that running a git clean would remove a file called “garbage-file”.
View More 3501
View More 3502
View More 3503
View More 3504
View More 3505
View More 3506
View More 3507
View More 3508
View More 3509
View More 3510
View More 3511
View More 3512
View More 3513
View More 3514
View More 3515
View More 3516
View More 3517
View More 3518
View More 3519
View More 3520
View More 3521
View More 3522
View More 3523
View More 3524
View More 3525
View More 3526
View More 3527
View More 3528
View More 3529
View More 3530
View More 3531
View More 3532
View More 3533
View More 3534
View More 3535
View More 3536
View More 3537
View More 3538
View More 3539
View More 3540
View More 3541
View More 3542
View More 3543
View More 3544
View More 3545
View More 3546
View More 3547
View More 3548
View More 3549
View More 3550
View More 3551
View More 3552
View More 3553
View More 3554
View More 3555
View More 3556
View More 3557
View More 3558
View More 3559
View More 3560
View More 3561
View More 3562
View More 3563
View More 3564
View More 3565
View More 3566
View More 3567
View More 3568
View More 3569
View More 3570
View More 3571
View More 3572
View More 3573
View More 3574
View More 3575
View More 3576
View More 3577
View More 3578
View More 3579
View More 3580
View More 3581
View More 3582
View More 3583
View More 3584
View More 3585
View More 3586
View More 3587
View More 3588
View More 3589
View More 3590
View More 3591
View More 3592
View More 3593
View More 3594
View More 3595
View More 3596
View More 3597
View More 3598
View More 3599
View More 3600
View More 3601
View More 3602
View More 3603
View More 3604
View More 3605
View More 3606
View More 3607
View More 3608
View More 3609
View More 3610
View More 3611
View More 3612
View More 3613
View More 3614
View More 3615
View More 3616
View More 3617
View More 3618
View More 3619
View More 3620
View More 3621
View More 3622
View More 3623
View More 3624
View More 3625
View More 3626
View More 3627
View More 3628
View More 3629
View More 3630
View More 3631
View More 3632
View More 3633
View More 3634
View More 3635
View More 3636
View More 3637
View More 3638
View More 3639
View More 3640
View More 3641
View More 3642
View More 3643
View More 3644
View More 3645
View More 3646
View More 3647
View More 3648
View More 3649
View More 3650
View More 3651
View More 3652
View More 3653
View More 3654
View More 3655
View More 3656
View More 3657
View More 3658
View More 3659
View More 3660
View More 3661
View More 3662
View More 3663
View More 3664
View More 3665
View More 3666
View More 3667
View More 3668
View More 3669
View More 3670
View More 3671
View More 3672
View More 3673
View More 3674
View More 3675
View More 3676
View More 3677
View More 3678
View More 3679
View More 3680
View More 3681
View More 3682
View More 3683
View More 3684
View More 3685
View More 3686
View More 3687
View More 3688
View More 3689
View More 3690
View More 3691
View More 3692
View More 3693
View More 3694
View More 3695
View More 3696
View More 3697
View More 3698
View More 3699
View More 3700
View More 3701
View More 3702
View More 3703
View More 3704
View More 3705
View More 3706
View More 3707
View More 3708
View More 3709
View More 3710
View More 3711
View More 3712
View More 3713
View More 3714
View More 3715
View More 3716
View More 3717
View More 3718
View More 3719
View More 3720
View More 3721
View More 3722
View More 3723
View More 3724
View More 3725
View More 3726
View More 3727
View More 3728
View More 3729
View More 3730
View More 3731
View More 3732
View More 3733
View More 3734
View More 3735
View More 3736
View More 3737
View More 3738
View More 3739
View More 3740
View More 3741
View More 3742
View More 3743
View More 3744
View More 3745
View More 3746
View More 3747
View More 3748
View More 3749
View More 3750
View More 3751
View More 3752
View More 3753
View More 3754
View More 3755
View More 3756
View More 3757
View More 3758
View More 3759
View More 3760
View More 3761
View More 3762
View More 3763
View More 3764
View More 3765
View More 3766
View More 3767
View More 3768
View More 3769
View More 3770
View More 3771
View More 3772
View More 3773
View More 3774
View More 3775
View More 3776
View More 3777
View More 3778
View More 3779
View More 3780
View More 3781
View More 3782
View More 3783
View More 3784
View More 3785
View More 3786
View More 3787
View More 3788
View More 3789
View More 3790
View More 3791
View More 3792
View More 3793
View More 3794
View More 3795
View More 3796
View More 3797
View More 3798
View More 3799
View More 3800
View More 3801
View More 3802
View More 3803
View More 3804
View More 3805
View More 3806
View More 3807
View More 3808
View More 3809
View More 3810
View More 3811
View More 3812
View More 3813
View More 3814
View More 3815
View More 3816
View More 3817
View More 3818
View More 3819
View More 3820
View More 3821
View More 3822
View More 3823
View More 3824
View More 3825
View More 3826
View More 3827
View More 3828
View More 3829
View More 3830
View More 3831
View More 3832
View More 3833
View More 3834
View More 3835
View More 3836
View More 3837
View More 3838
View More 3839
View More 3840
View More 3841
View More 3842
View More 3843
View More 3844
View More 3845
View More 3846
View More 3847
View More 3848
View More 3849
View More 3850
View More 3851
View More 3852
View More 3853
View More 3854
View More 3855
View More 3856
View More 3857
View More 3858
View More 3859
View More 3860
View More 3861
View More 3862
View More 3863
View More 3864
View More 3865
View More 3866
View More 3867
View More 3868
View More 3869
View More 3870
View More 3871
View More 3872
View More 3873
View More 3874
View More 3875
View More 3876
View More 3877
View More 3878
View More 3879
View More 3880
View More 3881
View More 3882
View More 3883
View More 3884
View More 3885
View More 3886
View More 3887
View More 3888
View More 3889
View More 3890
View More 3891
View More 3892
View More 3893
View More 3894
View More 3895
View More 3896
View More 3897
View More 3898
View More 3899
View More 3900
View More 3901
View More 3902
View More 3903
View More 3904
View More 3905
View More 3906
View More 3907
View More 3908
View More 3909
View More 3910
View More 3911
View More 3912
View More 3913
View More 3914
View More 3915
View More 3916
View More 3917
View More 3918
View More 3919
View More 3920
View More 3921
View More 3922
View More 3923
View More 3924
View More 3925
View More 3926
View More 3927
View More 3928
View More 3929
View More 3930
View More 3931
View More 3932
View More 3933
View More 3934
View More 3935
View More 3936
View More 3937
View More 3938
View More 3939
View More 3940
View More 3941
View More 3942
View More 3943
View More 3944
View More 3945
View More 3946
View More 3947
View More 3948
View More 3949
View More 3950
View More 3951
View More 3952
View More 3953
View More 3954
View More 3955
View More 3956
View More 3957
View More 3958
View More 3959
View More 3960
View More 3961
View More 3962
View More 3963
View More 3964
View More 3965
View More 3966
View More 3967
View More 3968
View More 3969
View More 3970
View More 3971
View More 3972
View More 3973
View More 3974
View More 3975
View More 3976
View More 3977
View More 3978
View More 3979
View More 3980
View More 3981
View More 3982
View More 3983
View More 3984
View More 3985
View More 3986
View More 3987
View More 3988
View More 3989
View More 3990
View More 3991
View More 3992
View More 3993
View More 3994
View More 3995
View More 3996
View More 3997
View More 3998
View More 3999
View More 4000
