下面是Stoyan Stefanov在他的JavaScript Patterns一书中是如何做到这一点的，我发现这本书非常好(它还展示了他如何做注释，允许自动生成API文档，以及如何向自定义对象的原型添加一个方法):

/**
* My JavaScript application
*
* @module myapp
*/

/** @namespace Namespace for MYAPP classes and functions. */
var MYAPP = MYAPP || {};

/**
* A maths utility
* @namespace MYAPP
* @class math_stuff
*/
MYAPP.math_stuff = {

    /**
    * Sums two numbers
    *
    * @method sum
    * @param {Number} a First number
    * @param {Number} b Second number
    * @return {Number} Sum of the inputs
    */
    sum: function (a, b) {
        return a + b;
    },

    /**
    * Multiplies two numbers
    *
    * @method multi
    * @param {Number} a First number
    * @param {Number} b Second number
    * @return {Number} The inputs multiplied
    */
    multi: function (a, b) {
        return a * b;
    }
};

/**
* Constructs Person objects
* @class Person
* @constructor
* @namespace MYAPP
* @param {String} First name
* @param {String} Last name
*/
MYAPP.Person = function (first, last) {

    /**
    * First name of the Person
    * @property first_name
    * @type String
    */
    this.first_name = first;

    /**
    * Last name of the Person
    * @property last_name
    * @type String
    */
    this.last_name = last;
};

/**
* Return Person's full name
*
* @method getName
* @return {String} First name + last name
*/
MYAPP.Person.prototype.getName = function () {
    return this.first_name + ' ' + this.last_name;
};

我最近最喜欢的图案是这样的:

Var命名空间=(函数(){ //暴露给公众 返回{ internalA, c: internalC ｝ //所有私有 ／** *完整的JSDoc * / 函数internalA() { / /…… ｝ ／** *完整的JSDoc * / 函数internalB() { / /…… ｝ ／** *完整的JSDoc * / 函数internalC() { / /…… ｝ ／** *完整的JSDoc * / 函数internalD() { / /…… ｝ }) ();

当然，return可以在后面，但是如果后面只有函数声明，那么就更容易看到名称空间是关于什么的，以及暴露了什么API。

在这种情况下使用函数表达式的模式导致不遍历整个代码就无法知道公开了哪些方法。

这是Ionuț G. Stan的回答的后续，但通过使用var ClassFirst = this显示了整洁代码的好处。ClassFirst = function(){…}，它利用JavaScript的闭包作用域来减少相同名称空间中的类的名称空间混乱。

var Namespace = new function() {
    var ClassFirst = this.ClassFirst = function() {
        this.abc = 123;
    }

    var ClassSecond = this.ClassSecond = function() {
        console.log("Cluttered way to access another class in namespace: ", new Namespace.ClassFirst().abc);
        console.log("Nicer way to access a class in same namespace: ", new ClassFirst().abc);
    }
}

var Namespace2 = new function() {
    var ClassFirst = this.ClassFirst = function() {
        this.abc = 666;
    }

    var ClassSecond = this.ClassSecond = function() {
        console.log("Cluttered way to access another class in namespace: ", new Namespace2.ClassFirst().abc);
        console.log("Nicer way to access a class in same namespace: ", new ClassFirst().abc);
    }
}

new Namespace.ClassSecond()
new Namespace2.ClassSecond()

输出:

Cluttered way to access another class in namespace: 123
Nicer way to access a class in same namespace: 123
Cluttered way to access another class in namespace: 666
Nicer way to access a class in same namespace: 666

我喜欢这个:

var yourNamespace = {

    foo: function() {
    },

    bar: function() {
    }
};

...

yourNamespace.foo();

这是user106826到Namespace.js的链接的后续。该项目似乎转移到了GitHub上。现在是smith/namespacedotjs。

我一直在我的小项目中使用这个简单的JavaScript助手，到目前为止，它似乎很轻，但足够通用，可以处理命名空间和加载模块/类。如果它允许我将包导入到我选择的名称空间中，而不仅仅是全局名称空间，那就太好了……唉，但这不是重点。

它允许你声明命名空间，然后在该命名空间中定义对象/模块:

Namespace('my.awesome.package');
my.awesome.package.WildClass = {};

另一种选择是立即声明名称空间及其内容:

Namespace('my.awesome.package', {
    SuperDuperClass: {
        saveTheDay: function() {
            alert('You are welcome.');
        }
    }
});

要了解更多用法示例，请查看源代码中的example.js文件。

模块模式最初被定义为在传统软件工程中为类提供私有和公共封装的一种方式。

在使用Module模式时，我们可能会发现定义一个简单的模板来开始使用它是很有用的。下面是一个涵盖了名称间距、公共变量和私有变量的例子。

在JavaScript中，Module模式被用来进一步模拟类的概念，这样我们就可以在单个对象中同时包含公共/私有方法和变量，从而将特定部分从全局作用域中屏蔽掉。这样做的结果是降低了我们的函数名与页面上其他脚本中定义的其他函数冲突的可能性。

var myNamespace = (function () {

  var myPrivateVar, myPrivateMethod;

  // A private counter variable
  myPrivateVar = 0;

  // A private function which logs any arguments
  myPrivateMethod = function( foo ) {
      console.log( foo );
  };

  return {

    // A public variable
    myPublicVar: "foo",

    // A public function utilizing privates
    myPublicFunction: function( bar ) {

      // Increment our private counter
      myPrivateVar++;

      // Call our private method using bar
      myPrivateMethod( bar );

    }
  };

})();

优势

为什么模块模式是一个很好的选择?首先，对于来自面向对象背景的开发人员来说，它比真正的封装思想要简洁得多，至少从JavaScript的角度来看是这样。

其次，它支持私有数据——因此，在模块模式中，代码的公共部分能够触及私有部分，而外部世界无法触及类的私有部分。

缺点

Module模式的缺点是，由于我们以不同的方式访问公共成员和私有成员，当我们希望更改可见性时，实际上必须对使用成员的每个位置进行更改。

我们也不能访问稍后添加到对象的方法中的私有成员。也就是说，在许多情况下，模块模式仍然是非常有用的，如果使用正确，肯定有潜力改善我们的应用程序的结构。

揭示模块模式

现在我们对模块模式有了一些熟悉，让我们来看看稍微改进的版本——Christian Heilmann的揭示模块模式。

当我们想要从一个公共方法调用另一个公共方法或访问公共变量时，他不得不重复主对象的名称，这使Heilmann感到沮丧，因此出现了揭示模块模式。他也不喜欢模块模式的要求，因为他希望公开的东西必须切换到对象文字符号。

他努力的结果是一种更新的模式，在这种模式中，我们只需在私有作用域中定义所有函数和变量，并返回一个匿名对象，该对象带有指向我们希望显示为公共的私有功能的指针。

下面是如何使用reveal Module模式的示例

var myRevealingModule = (function () {

        var privateVar = "Ben Cherry",
            publicVar = "Hey there!";

        function privateFunction() {
            console.log( "Name:" + privateVar );
        }

        function publicSetName( strName ) {
            privateVar = strName;
        }

        function publicGetName() {
            privateFunction();
        }


        // Reveal public pointers to
        // private functions and properties

        return {
            setName: publicSetName,
            greeting: publicVar,
            getName: publicGetName
        };

    })();

myRevealingModule.setName( "Paul Kinlan" );

优势

这种模式使得脚本的语法更加一致。在模块的末尾，它还使哪些函数和变量可以被公开访问更加清楚，从而降低了可读性。

缺点

这种模式的一个缺点是，如果一个私有函数引用了一个公共函数，那么如果需要一个补丁，这个公共函数就不能被覆盖。这是因为私有函数将继续引用私有实现，并且该模式不应用于公共成员，只应用于函数。

引用私有变量的公共对象成员也遵循上面的无补丁规则。