61

On wikipedia, the article for .sh says:

For the .sh file extension type, see Bourne shell.

How about other unix shells?

I know that the shebang is used inside the file to indicate an interpreter for execution, but I wonder:

  • What are the pros and cons for files extensions vs no file extensions?
3
  • 4
    Sometimes, shell scripts without shebang (or without exec permissions) can be found. In that case, a name ending in .sh can be a hint to the user to run them with bash script.sh (or sh, of course). Commented Feb 15, 2012 at 16:15
  • 3
    If a shell script has an extension it is commonly .sh. I have never seen a .ksh or .bash script. Most shell scripts have no extension though, like all the scripts in /etc/init.d/* as an example. Commented Feb 15, 2012 at 22:48
  • While a simplistic conclusion (yes or no) is opinion, the things to consider are not. Commented Oct 17, 2019 at 19:36

7 Answers 7

48

I would only call .sh something that is meant to be portable (and hopefully is portable).

Otherwise I think it's just better to hide the language. The careful reader will find it in the shebang line anyway. (In practice, .bash or .zsh, etc… suffixes are rarely used.)

4
  • 3
    From this page alone, we can already see quite a nontrivial amount of people using it. Why do you say they are "rarely used"? Any citations? Or is this merely based on your experience?
    – Pacerier
    Commented Sep 15, 2015 at 10:07
  • 2
    I would use .bash if it's meant to be sourced by another script and is only compatible with bash, etc. If it can be sourced by any bourne-compatible shell such as sh, dash, or bash, I would give it a .sh extension. If it's meant to be executed, I wouldn't put an extension. Commented Jan 11, 2021 at 17:19
  • 3
    I agree with hiding the language for executables, but I would elaborate that this isn't "just" better for not reason: it's very specifically better because putting the language in the executable name leaks an implementation detail into the interface! Why predict the future and say that your program will always be written as a shell script, or commit yourself to lying or breaking backwards compatibility if you ever have good reason to rewrite it in another language?
    – mtraceur
    Commented Apr 17, 2023 at 18:48
  • 2
    But I would assert that the best practice for libraries (files meant to be sourced by shells) is to say what shell it's meant to be sourced by in the extension, like @BrandonMiller said. Most people write sourceable files for just one shell, so for the common case that's trivial. Intentionally portable files can usually use the least featureful shell's name/extension (and in the very small corner case of for example supporting both bash and zsh but nothing else, you could just link/symlink/copy the file to both names, or put both extensions in the name).
    – mtraceur
    Commented Apr 17, 2023 at 18:52
30

I would say that no "good practices" for file extensions exist, strictly on a technicality: Unix/Linux/*BSD file systems don't support extensions per se. What you are calling an extension is merely a suffix of a single file name. That's different than the VM/CMS, VMS, MS-DOS and Windows file systems and OSes where a special spot in the inode-moral-equivalent is reserved for an extension.

That little rant now over, I think it's a bit silly to put a ".sh" or ".ksh" or ".bash" suffix on a shell script file name. A program is a program: no benefit exists in distinguishing what gets executed. No unix or linux or whatever kernel has decided to call an interpreter on some file just because of a file name suffix. It's all done by the #! line, or some other "magic number" sequence of bytes at the beginning of the file. In fact, deciding what to execute based on a file name "extension" is one of the factors that makes Windows a malware magnet. Look at how many Windows malware scams involve a file named "something.jpg.exe" - by default newer Windows don't show the ".exe" extension, and encourage a user to just double click on the "image". Instead of an image view running, the malware runs.

What you might think of as a straight-ahead command is often a shell script anyway. Sometimes cc has been a sh-script, firefox is an sh-script, startx is an sh-script. I don't believe there's a cognitive or organizational benefit to marking a script with a ".sh" suffix.

10
  • 37
    I disagree! My job consists of packaging an application involving thousands of files ranging from binary executables to shell scripts (ksh, bash and some legacy csh). To me, believe me it does make a difference to be able to know in a glance (or in a regex) what kind of file we are discussing and we are looking for. My point is that there could be a benefit in distinguishing what gets excuted and a best practice should encourage stating explicitly the type of file.
    – rahmu
    Commented Feb 15, 2012 at 16:31
  • 11
    @rahmu: write that up as an answer. Give some specifics about how regex-distinguishable names help you package (and maybe maintain) that application. Note specifically the interaction between what interprets the file and the file name's suffix and how that aids you in doing tasks. I'm interested in serious arguments against my viewpoint, and I'm willing to change if I'm convinced. I upvoted your comment to prove it.
    – user732
    Commented Feb 15, 2012 at 16:57
  • 3
    I would love to, unfortunately I can only speak of my current experience in my current job. I don't know much about good practice and standards in general; I feel I should do some research before posting an answer here. I'll look into it tonight after work :)
    – rahmu
    Commented Feb 15, 2012 at 17:19
  • 4
    @rahmu The "file" command exists for determining file type. It is capable of distinguishing scripts written for different shells.
    – Matt
    Commented Jun 18, 2013 at 13:21
  • 9
    If you give a shell script a .sh extension, you'll have to type that .sh as part of the command name when starting it. That's the main reason why I don't like putting that extension in (same with anything having a shebang line). BTW, the problem in Windows is not the .exe prefix per se (it's trivial to make an executable named image.jpg in Linux, after all), but the fact that Windows usually hides that extension, combined with the fact that the action needed to start an executable and to open a document is exactly the same.
    – celtschk
    Commented Apr 30, 2014 at 19:20
16

As one who has worked in a multitude of ?nix environments, I have had to write in a wide variety of shells. Believe it or not, across platforms, the shells are not the same. So if you maintain your personal library in multiple shells (when necessary) it is very helpful to use extensions to ID the shells. That way when you move to another platform and the shell is slightly different, you know what scripts to target for modifications. .sh .ksh .bsh .csh ...

6
  • 1
    This seems to agree with unix.stackexchange.com/questions/31760/…
    – Pacerier
    Commented Sep 15, 2015 at 10:05
  • 3
    Do you not have a #! at the start of the script (e.g. #!/bin/bash)? Commented Jul 11, 2019 at 8:06
  • 2
    Gnu/Linux, BSD, and the UNIXes are all Unix. No need for ?nix. Linux is a kernel, android used Linux but is not a Unix (unless you add extra software, in which case you have a Unix app). Commented Jul 11, 2019 at 8:10
  • 1
    @ctrl-alt-delor: "Unix" is a trademark. People often use "?nix" to avoid the trademark issue (and the pedants).
    – JS.
    Commented Oct 17, 2019 at 16:51
  • 2
    @JS `UNIX' is a trademark of The Open Group. Unix and unix are not greens.org/about/unix.html Commented Oct 17, 2019 at 19:22
11

You should not use an extension for executables, as they they are not interchangeable. Imagine that you have a shell script a.sh, then re-write in python a.py, you now have to change every program that calls you script, you have leaked implementation detail.

The whole file-name extension thing in Mircosoft's Windows is a mess: for example what could have been a.audio, b.audio, c.audio, is a.mp3, b.wav, c.ogg, and d.picture, e.picture, f.picture is d.jpeg, e.png, f.gif. Most of the time we do not care what format the audio or picture is in. We also have to spend a long time teaching new users all of the file extensions.

1
6

As you said it, the Unix file extensions are purely information. You just need your script to have a correct shebang and being executable.

You can either have no extension or using .sh.

I personnaly use the following conventions, regardless of the shell used (csh, tcsh, bash, sh, ...):

  • no extension for system or high grade scripts (extremely rare).
  • the .sh for classic scripts, low to high grade.
2
  • 4
    What do you mean by "classic scripts, low to high grade"?
    – Pacerier
    Commented Sep 15, 2015 at 10:04
  • I think I meant abstraction or organisation level by that. That is you don't care what language/script tool is used behind some commands : so you don't use any extension. For others, it is good to known that it is a bash or some exotic ksh shell script (with the proper extension). ... but that was 2 years ago ;)
    – Ouki
    Commented Sep 15, 2015 at 11:59
4

Shell script extensions are quite useful. For example I often write scripts that have multiple files in multiple languages (eg. bash, awk and lua) in the same directory. If I need to search for a string in only the bash files, the extension makes this very handy, to reduce false positives. Or if I want to do a line count of all my bash code for that project.

It is a pain to have to type the extension when running the program, so I also make a symlink without the extension to the main executable, to edit/run it without needing to type the extension each time. Symlinks are cheap and easy.

1
2

As others have said, the shell doesn't care about extensions. However, it does allow for quick human identification of files. I see files ending in .py or .sh and I quickly know what they (at least) should be. As Steve says, searching by file extension or doing a line count are also practical considerations.

Not the answer you're looking for? Browse other questions tagged .