From ac9594b890e5259af54c16c684c30aaa9c7e78f1 Mon Sep 17 00:00:00 2001
From: liyang <1711467488@qq.com>
Date: Sat, 7 Jul 2018 12:42:47 +0800
Subject: [PATCH] =?UTF-8?q?node-sass=20=E5=AE=89=E8=A3=85=E5=A4=B1?=
 =?UTF-8?q?=E8=B4=A5=20=E7=AB=A0=E8=8A=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Former-commit-id: 22d4867a369653f76ea86afb7596eb43ecc17ec8 [formerly 483eb858386fbc781c37f1f891b616d4df0ef367] [formerly 22d4867a369653f76ea86afb7596eb43ecc17ec8 [formerly 483eb858386fbc781c37f1f891b616d4df0ef367] [formerly 22d4867a369653f76ea86afb7596eb43ecc17ec8 [formerly 483eb858386fbc781c37f1f891b616d4df0ef367] [formerly 483eb858386fbc781c37f1f891b616d4df0ef367 [formerly 51f487d9593d7113181533a75106901d2e2b2e00 [formerly 20e8ba01b9aeb2d07ac0534957f658febbe53445]]]]]
Former-commit-id: e0174f746608a8932b63ea4d579a7fc4d2babfa9
Former-commit-id: 39e5573151f459298f003176291fdeda0f48bf6b
Former-commit-id: f8b6830ff112d5f8119a44b9d771dbf03ffe6aa2 [formerly f8dfd9823f92d1b1fe7591cb19fce2cf07b5e32c]
Former-commit-id: 46f648c75222df807e6e53e81a556c4deb02581e
Former-commit-id: aa466772d6ea7f4977bc96bd6ce654dc10cfcc71
Former-commit-id: 076f2b4765428ff30cbf087e25ea82cf5a4580e8
Former-commit-id: 4bc654561555ab862d40d5d545d9518fcca02102
Former-commit-id: 6d93f43f3932a266102c7a7d2a1c35e0a6c97be4
---
 docs/.vuepress/dist       |  2 +-
 docs/zh/guide/question.md | 99 +++++++++++++++++++++++++++++++++++----
 2 files changed, 90 insertions(+), 11 deletions(-)

diff --git a/docs/.vuepress/dist b/docs/.vuepress/dist
index 1628dcda..a76e1b8a 160000
--- a/docs/.vuepress/dist
+++ b/docs/.vuepress/dist
@@ -1 +1 @@
-Subproject commit 1628dcda59e328732ebf96b543c1537d82b12106
+Subproject commit a76e1b8a67c46af73a7e92a13a35e34c3bf71982
diff --git a/docs/zh/guide/question.md b/docs/zh/guide/question.md
index 2f72b9ef..73ea1f81 100644
--- a/docs/zh/guide/question.md
+++ b/docs/zh/guide/question.md
@@ -4,7 +4,7 @@
 
 ## 无法启动项目
 
-首先建议您升级 node 版本 > 8，在以下环境测试可用
+如果在 `run dev` 或者 `npm i` 的过程中报错，首先建议您升级 node 版本 > 8，在以下环境测试可用
 
 ``` {10}
 ➜  ~ npm -v
@@ -23,12 +23,91 @@ v8.11.1
   edunpm - http://registry.enpmjs.org/
 ```
 
-还有可能的原因是网络环境不好，node-sass 安装有可能会卡住，这时候需要科学上网办法解决这个问题
-
 ::: tip
 推荐使用 [nrm](https://github.com/Pana/nrm) 管理 npm 源，不建议使用 cnpm
 :::
 
+在正在开发的 1.2.x 版本（也有可能在你看到这的时候版本已经比 1.2.x 更晚）中，我们不再使用 npm 作为推荐的包安装工具，取而代之的是使用 [yarn](https://yarnpkg.com/zh-Hans/)，使用方法如下
+
+```
+// 安装依赖
+yarn
+// 启动调试服务
+yarn run serve
+```
+
+## node-sass 安装失败
+
+由于某些不可描述的原因，利用 npm 进行安装模块的时候会发生包下载失败的情况，node-sass 尤其的频繁，或者说 node-sass 的二进制文件是接近百分百失败的，即使用 yarn 安装也依旧在这个点失败，给出以下建议
+
+**方法1**
+
+首先，需要提前下载 node-sass 的二进制文件，这个文件可以去 cnpm 仓库下载或者 node-sass 的 github 上去下载，在下载之前我们需要先查看电脑的系统的版本，来确定适合哪个版本的二进制文件，查看版本的指令如下：
+
+``` sh
+node -p "[process.platform, process.arch, process.versions.modules].join('-')"
+```
+
+输入这个指令后会弹出一个系统版本，然后在下面两个地址中选择一个去下载对应系统版本的后缀为 .node 的 node-sass 文件
+
+[cnpm https://npm.taobao.org/mirrors/node-sass/](https://npm.taobao.org/mirrors/node-sass/)
+
+[github https://github.com/sass/node-sass/releases](https://github.com/sass/node-sass/releases)
+
+下载完保存到任意位置，最好放置到 package.json 所在位置。然后我们需要手动指定 node-sass 二进制文件的下载源为下载的那个文件，以下是npm与yanr的指令：
+
+npm
+
+``` sh
+npm config set sass-binary-path 你存放刚才下载的二进制文件的目录
+// 例如 npm config set sass-binary-path e:/web/win32-x64-48_binding.node
+```
+
+yarn
+
+``` sh
+yarn config set sass-binary-path 你存放刚才下载的二进制文件的目录
+// 例如 yarn config set sass-binary-path e:/web/win32-x64-48_binding.node
+```
+
+然后我们即可用正常指令下载了
+
+::: tip 注意
+此方法会绑定为本地文件，即无法更新 node-sass 了。如果不希望这样，请使用第二种方法
+:::
+
+**方法2**
+
+此方案将把下载源指定为cnpm仓库
+
+全部的下载源指向cnpm的指令
+
+npm
+
+``` sh
+npm config set registry http://registry.npm.taobao.org
+```
+
+yarn
+
+``` sh
+yarn config set registry http://registry.npm.taobao.org
+```
+
+只指定node-sass的下载源
+
+npm
+
+``` sh
+npm config set sass-binary-site http://npm.taobao.org/mirrors/node-sass
+```
+
+yarn
+
+``` sh
+yarn config set sass-binary-site http://npm.taobao.org/mirrors/node-sass
+```
+
 ## 无法跳转路由
 
 有可能你在 D2Admin 的基础上进行你的开发时，发现在登陆页面进行
@@ -83,13 +162,13 @@ D2Admin 会在很多地方使用 cookie 中的此字段区分用户，比如不
 
 首先将 vuepress 安装到全局
 
-```
+``` sh
 npm i -g vuepress
 ```
 
 启动服务
 
-```
+``` sh
 npm run doc:dev
 ```
 
@@ -146,7 +225,7 @@ const demoChart = {
 }
 ```
 
-``` js{5,12}
+``` js {5,12}
 export const side = [
   demoPlugins,
   demoComponents,
@@ -162,7 +241,7 @@ export const side = [
 ]
 ```
 
-``` js{13,31}
+``` js {13,31}
 export default [
   {
     path: '/index',
@@ -206,7 +285,7 @@ export default [
 
 * 删除 `src/components/index.js` 中的相关内容（高亮部分）
 
-```js{5-6}
+```js {5-6}
 // 核心组件
 import './core/register'
 // 非核心组件 只是在很多演示页面中用到的组件
@@ -219,7 +298,7 @@ import './charts/register'
 
 * 删除 `src/mock/register.js` 中的相关内容（高亮部分）
 
-```js{7}
+```js {7}
 import Mock from 'mockjs'
 
 import '@/mock/ajax-demo'
@@ -240,7 +319,7 @@ Mock.setup({
 
 打开终端 cd 到项目文件夹，执行
 
-```
+``` sh
 npm remove @antv/data-set -S
 npm remove @antv/g2 -S
 ```