# 路径 (Path)
~~~
稳定度: 3 - 稳定
~~~
本模块包含一套用于处理和转换文件路径的工具集。几乎所有的方法仅对字符串进行转换， 文件系统是不会检查路径是否真实有效的。
通过 `require('path')` 来加载此模块。以下是本模块所提供的方法：
### path.normalize(p)
规范化字符串路径，注意 `'..'` 和 `'.' 部分
当发现有多个连续的斜杠时，会替换成一个； 当路径末尾包含斜杠时，会保留； 在 Windows 系统会使用反斜杠。
实例：
~~~
path.normalize('/foo/bar//baz/asdf/quux/..')
// returns
'/foo/bar/baz/asdf'
~~~
### path.join([path1], [path2], [...])
组合参数中的所有路径，返回规范化后的路径。
参数必须是字符串。在 v0.8 版本非字符串参数会被悄悄忽略。 在 v0.10 及以后版本将会抛出一个异常。
实例：
~~~
path.join('foo', {}, 'bar')
// 抛出异常
TypeError: Arguments to path.join must be strings
~~~
### path.resolve([from ...], to)
将 `to` 参数解析为一个绝对路径。
如果`to`不是一个相对于`from` 参数的绝对路径，`to`会被添加到`from`的右边，直到找出一个绝对路径为止。如果使用`from`路径且仍没有找到绝对路径时，使用当时路径作为目录。返回的结果已经规范化，得到的路径会去掉结尾的斜杠，除非得到的当前路径为root目录。非字符串参数将被忽略。
另一种思考方式就是像在shell里面用一系列的‘cd’命令一样.
~~~
path.resolve('foo/bar', '/tmp/file/', '..', 'a/../subfile')
~~~
相当于:
~~~
cd foo/bar
cd /tmp/file/
cd ..
cd a/../subfile
pwd
~~~
不同的是，不同的路径不需要存在的，也可能是文件。
示例:
~~~
path.resolve('wwwroot', 'static_files/png/', '../gif/image.gif')
// 如果当前工作目录为 /home/myself/node，它返回：
'/home/myself/node/wwwroot/static_files/gif/image.gif'
~~~
### path.isAbsolute(path)
判定`path`是否为绝对路径。一个绝对路径总是指向一个相同的位置，无论当前工作目录是在哪里。
Posix 示例:
~~~
path.isAbsolute('/foo/bar') // true
path.isAbsolute('/baz/..') // true
path.isAbsolute('qux/') // false
path.isAbsolute('.') // false
~~~
Windows 示例:
~~~
path.isAbsolute('//server') // true
path.isAbsolute('C:/foo/..') // true
path.isAbsolute('bar\\baz') // false
path.isAbsolute('.') // false
~~~
### path.relative(from, to)
解决从`from`到`to`的相对路径。
有时我们有2个绝对路径, 我们需要从中找出相对目录的起源目录。这完全是`path.resolve`的相反实现,我们可以看看是什么意思:
~~~
path.resolve(from, path.relative(from, to)) == path.resolve(to)
~~~
示例:
~~~
path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb')
// 返回
'../../impl/bbb'
~~~
### path.dirname(p)
返回路径中文件夹的名称. 类似于Unix的`dirname` 命令.
实例：
~~~
path.dirname('/foo/bar/baz/asdf/quux')
// returns
'/foo/bar/baz/asdf'
~~~
### path.basename(p, [ext])
返回路径中的最后哦一部分. 类似于Unix 的 `basename` 命令.
实例：
~~~
path.basename('/foo/bar/baz/asdf/quux.html', '.html')
// returns
'quux'
~~~
