ReasonML中如何为编译输出添加Shebang？

我之前也碰到过这个问题！直接在Reason代码里写Shebang肯定会编译报错，因为ReasonML的语法不允许第一行是#!开头的内容（编译器会把它当成非法语法）。下面给你几个可行的解决方案：

如果你用的是BuckleScript（现在也叫ReScript，核心配置逻辑一致），可以直接在bsconfig.json里配置自动添加Shebang。修改package-specs字段：

{
  "package-specs": {
    "module": "commonjs", // 命令行工具建议用commonjs模块格式
    "in-source": false,
    "shebang": true // 关键字段：设为true后编译会自动给JS文件加Shebang
  }
}

保存配置后重新执行编译命令，生成的JS文件开头就会自动带上#!/usr/bin/env node，完全不用手动修改代码。注意这个功能需要BuckleScript 7.0及以上版本，如果你的版本偏旧，建议升级一下依赖。

如果你的BuckleScript版本不支持shebang配置，或者需要更灵活的定制，可以写个简单脚本，在编译完成后给输出的JS文件插入Shebang。

Shell脚本实现（适合类Unix系统） #

1. 新建add-shebang.sh文件，内容如下：

#!/bin/bash
# 替换成你的编译输出文件路径
CLI_FILE="lib/js/src/YourCLIFilename.js"
# 读取文件内容并在开头插入Shebang
echo -e "#!/usr/bin/env node\n$(cat $CLI_FILE)" > $CLI_FILE

2. 给脚本添加可执行权限：chmod +x add-shebang.sh
3. 修改package.json的build命令，让编译后自动执行脚本：

"scripts": {
  "build": "bsb -make-world && ./add-shebang.sh"
}

Node.js脚本实现（跨平台友好） #

如果需要在Windows环境也能运行，可以用Node.js写脚本：

1. 新建add-shebang.js：

const fs = require('fs');
const path = require('path');

// 替换成你的编译输出文件路径
const cliFilePath = path.join(__dirname, 'lib/js/src/YourCLIFilename.js');

const originalContent = fs.readFileSync(cliFilePath, 'utf8');
const withShebang = `#!/usr/bin/env node\n${originalContent}`;

fs.writeFileSync(cliFilePath, withShebang);

2. 修改package.json的build命令：

"scripts": {
  "build": "bsb -make-world && node add-shebang.js"
}

不管用哪种方法，添加完Shebang后，别忘了给生成的JS文件加上可执行权限：

chmod +x lib/js/src/YourCLIFilename.js

或者你可以在package.json里配置bin字段，比如：

"bin": {
  "your-cli-name": "./lib/js/src/YourCLIFilename.js"
}

这样当你用npm link测试本地包，或者发布到npm时，npm会自动帮你处理可执行权限。

内容的提问来源于stack exchange，提问作者Jian