createuser创建一个新的PostgreSQL 用户(更准确地说是一个角色)。 只有超级用户和有CREATEROLE权限的用户可以创建新的用户。 因此，createuser必须由超级用户或者是有CREATEROLE 权限的用户执行。
如果你希望创建一个新的超级用户，你必须以超级用户身份连接， 而不仅仅是一个有CREATEROLE权限的用户。 成为超级用户就意味着将在数据库里绕开所有访问权限检查，因此，不要轻易赋予超级用户权限。
createuser是SQL命令CREATE ROLE的封装。 因此，这两种方法创建的新用户没什么差别。
createuser接受下列命令行参数：
要创建的PostgreSQL角色名称。 该名称必须在该PostgreSQL安装的所有角色中唯一。
为新用户设置最大数目的连接数。缺省为无限制。
允许该新建用户创建数据库
禁止该新建用户创建数据库。
回显createuser生成并发送到服务器的命令。
对用户存储在数据库里的口令进行加密。如果没有声明，使用缺省的口令行为。
新角色将自动继承其所属角色组的权限。这个是缺省。
新角色将不会自动继承他所属角色组的权限。
新用户将允许登录，也就是说，用户名可以用作初始会话的用户标识。这个是缺省。
新用户将不允许登录。一个不能登录的角色仍然是很有用的，比如用于权限管理。
不要加密用户存储在数据库里的口令。如果没有声明，使用缺省的口令行为。
如果给出，createuser将发出一个提示符要求输入新用户的口令。 如果你不打算用口令认证，那么这是不必要的。
新用户将被允许创建新角色，也就是说，这个用户将有CREATEROLE权限。
新用户将不允许创建新角色。
表明新用户将是超级用户
新用户将不是超级用户。
输出createuser版本并退出。
显示关于createuser命令行参数的帮助并退出。
如果没有在命令行上声明必须的信息，程序会提示你输入。
createuser还接受下列命令行参数作为连接参数：
指定运行服务器的主机名。如果数值以斜杠开头，则被用作到Unix域套接字的路径。
指定服务器正在侦听的TCP端口或本地Unix域套接字文件的扩展(描述符)
连接的用户名(不是要创建的用户名)
不发布密码提示。若服务器请求密码认证并且一个密码不能通过像 .pgpass文件这样的其他方式来获得，连接 尝试将失败。该选项在批量作业和脚本中是有效的，在目前没有用 户输入密码的地方。
强制createuser在连接到数据库之前提示密码。
该选项从不是最重要的，尽管若服务器请求密码认证 createuser会自动提示密码。然而， createuser将浪费一个连接尝试来发现服务器想 要一个密码。在一些情况下，输入-W来避免额外的连接尝试。
如果出现问题，将会显示后端错误信息。 参阅CREATE ROLE 和psql获取可用信息的描述。数据库服务器必须在目标主机上运行。 同样，任何libpq 前端库使用的缺省连接设置和环境变量都将适用。
在缺省数据库服务器上创建一个joe用户：
$ createuser joe Shall the new role be a superuser? (y/n) n Shall the new role be allowed to create databases? (y/n) n Shall the new role be allowed to create more new roles? (y/n) n
用在主机eden上的服务器里创建joe用户， 端口是5000，避免提示并且回显执行的命令：
$ createuser -h eden -p 5000 -S -D -R -e joe CREATE ROLE joe NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN;
把用户joe创建为超级用户，并且立即赋予口令：
$ createuser -P -s -e joe Enter password for new role: xyzzy Enter it again: xyzzy CREATE ROLE joe PASSWORD 'md5b5f5ba1a423792b526f799ae4eb3d59e' SUPERUSER CREATEDB CREATEROLE INHERIT LOGIN;
在上面例子中，虽然新口令在输入的时候实际上并不会实际显示出来， 但是我们还是明确的把它显示出来了。 正如你所看到的，密码在发送给客户之前会加密。若果选项--unencrypted 被使用，密码will会出现在回送命令中（并且也可能在服务器日志或其他地方）， 所以你在那种情况下您不想使用-e，倘若任何其他人都能看到你的屏幕。