几种开发工具

几种开发工具配置和使用

Node.js

1. 安装 nvm

nvm 是一个用于 Linux 和 Mac OS 的 nodejs 版本管理工具，避免了使用不同版本 node 时频繁卸载安装的问题，其工作原理为更改环境变量中的 node 路径为指定版本的 node 路径。Windows 下类似的工具是 nvm-win，下载最新安装版安装即可。

• 设置 node 安装目录：

nvm root [node_path]

• 设置 nodejs 镜像源：

nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

• 卸载/安装 node：

nvm [un]install latest # latest version
nvm [un]install lts # latest lts version
nvm [un]install xx.xx.xx # give the version number

• 使用指定版本 node：

nvm use latest/lts/xx.xx.xx

2. 配置

• 将 nodejs 主目录添加到环境变量 path 中，安装时默认添加，使用 nvm 时忽略这步。
• 配置全局模块安装目录，默认在 C 盘用户目录的 AppData 文件夹下：

npm config set prefix "[dest]\node_global_modules"

• 配置包下载缓存目录，默认仍然在 C 盘用户目录 AppData 文件夹下：

npm config set cache "[dest]\node_cache"

• 配置国内镜像源，加快包的下载速度：

npm config set registry=http://registry.npm.taobao.org -g

3. 可能出现的问题

若安装后命令不生效，可以重启电脑或者使用管理员权限重试。

4. 安装 GitBook

npm install gitbook-cli -g # 全局安装

检验是否安装成功：

gitbook -V

若此时卡在installing GitBook 3.2.3，并显示如下错误信息：

gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js:287:18
at FSReqCallback.oncomplete (fs.js:169:5)

则原因为gitbook-cli引用了旧版的graceful-fs库，进入gitbook-cli全局安装目录下的node依赖文件夹...\gitbook-cli\node_modules\npm\node_modules，执行以下命令更新graceful-fs库即可。

npm install graceful-fs@latest --save # 2022.03.17更，此操作已失效

导致以上问题的根本原因为旧版graceful-ful库下polyfills.js文件中statFix()函数的问题，到这里下载修复后的polyfills.js文件替换原来的polyfills.js文件。需要注意的是，gitbook-cli全局安装目录下有两处出现了graceful-fs库，一是...\gitbook-cli\node_modules\，二是...\gitbook-cli\node_modules\npm\node_modules，这两个graceful-fs库中的polyfills.js文件都需要进行替换。

Gitbook 本地版由于年久失修，使用最新版的 node 安装会较大概率地出现各种问题，推荐使用在线版 GitBook，或使用 v12.18.2 及其之前版本的 node 安装。

Java

1. 安装

在 Oracle 官网下载 Java 1.8 安装，安装的同时也会安装 jre，1.8 版本使用较广，兼容性比新版本好一点。

2. 配置

• 新建环境变量 JAVA_HOME，值为 jdk 主目录的所在路径，一般为...\jdk xx.xx.xx
• 将 jdk 主目录下的 bin 文件夹添加到环境变量 path 中。

3. 验证安装

java -v
javac -v

Python

1. 安装

python 官网下载安装

2. 配置

• 更改镜像源

  更改 pip 命令的安装源为国内的镜像源，提高包的下载速度，在 C 盘的用户目录下新建文件夹 pip，在其中新建文件 pip.ini，写入以下内容：

[global]
    timeout = 6000
    index-url = https://pypi.tuna.tsinghua.edu.cn/simple
    # <==> pip install -i [index-url] [pkg_name]
[install]
    trusted-host = mirrors.aliyun.com

3. 第三方库的批量导入和导出

• 导出

pip freeze > [path]\requirements.txt

• 导入

pip install -r requirements.txt

4. python 虚拟环境使用

• 直接使用默认环境的缺点有：
  • 不同项目使用的第三方依赖都装在同一个目录下，不方便管理
  • 不同项目可能依赖同一个库的不同版本，可能产生冲突
  • 只能使用一个版本的 python 解释器
• 使用 venv 模块创建新的 python 虚拟环境
  这会在当前目录下生成一个名为 .venv_name 的文件夹，这个虚拟环境和外部 python 环境是相互独立、互不影响的。

python -m venv [.venv_name]

• 激活虚拟环境
  推荐使用管理员权限执行以下操作，否则可能激活失败，激活成功后，第三方库会被安装在 .\venv_name\Lib\site-packages\ 下。

source ./venv_name/Scripts/activate # linux / Mac OS
./venv_name/Scripts/activate.bat # cmd
./venv_name/Scripts/activate.ps1 # powershell

• 退出虚拟环境

deactivate

5. pycrypto 模块安装

• 由于该库已经停止维护，使用 pip 命令通常安装不上该模块，可安装基于 pycrypto 库开发的 pycryptodome 库代替。

pip install pycryptodome

若命令 from Crypto.Cipher import AES 报错，可到 python 的包安装目录 site-packages 下将 crypto 文件夹首字母大写为 Crypto。

Git

1. 安装

Git 官网下载安装。

2. 配置

首先将 git 主目录添加到环境变量 path 中，然后设置全局用户名和邮箱，作为 git commit 的发起用户。

git config --global user.name "your github user name"
git config --global user.email "your email account used in github"

3. 使用技巧

git 上手比较简单，但是有很多细节只有在深入的使用和理解后才能真正掌握，下面列出一些基本的用法：

# 基本用法
git init        # 初始化仓库
git add         # 将文件添加到暂存区
git restore     # 还原暂存区文件
git rm          # 删除暂存区文件
git status      # 查看 Git 当前状态
git commit      # 将暂存区文件更改提交到仓库
git log         # 查看提交历史提交记录
git log --pretty=oneline --graph --abbrev-commit    # 简化历史提交输出内容
git reset [commit]          # 回退到指定的提交版本
git rebase -i HEAD~n        # 修改倒数 n 次提交
git rebase -i --root        # 修改所有提交
git commit --amend          # 修改最近一次的提交信息
git branch                  # 查看仓库分支
git branch [name]           # 新建分支
git checkout [name]         # 切换分支
git branch -m [old] [new]   # 修改分支名
git --help                  # 获取命令使用帮助
git [cmd] --help            # 获取指定子命令的使用帮助，如：git init --help
# 远程协作
git push        # 将本地仓库更改推送到远程仓库
git push -f     # 将本地仓库内容强制（覆盖）推送到远程仓库
git pull        # 拉取远程仓库内容到本地仓库
git remote      # 查看现有的远程仓库
git remote -v   # 查看远程仓库详细信息
git remote add [name] [url]     # 添加远程仓库
git remote rename [old] [new]   # 重命名远程仓库
git clone [url] [path]          # 将远程仓库克隆到本地文件夹下

MySQL

1. 安装

MySQL 官网下载免费的社区安装版本，安装时推荐勾选 MySQL WorkBench ，作为数据库的图形化操作界面。

2. 配置

首次使用需要设置用户名和密码，使用 idea 等软件连接时确保 mysql 服务已经启动。

3. IDEA 配置 MySQL

问题：IEDA 中配置 MySQL 出现 Server returns invalid timezone. Go to 'Advanced' tab and set 'serverTimezone' property manually 报错。

原因：MySQL 驱动 jar 中的默认时区是 UTC，其代表的是全球标准时间 ，但是我们使用的时间是北京时区-东八区，领先 UTC 八个小时，因为时区不一致，导致了该错误。

解决方法有以下三个：

• 在 Advanced 面板下将 serverTimezone 设置为 Asia/Shanghai
• 在连接数据库的 url 后面添加参数 ?serverTimezone=UTC，设置时区为 UTC
• 更改 MySQL 的配置文件 my.ini 如下：

[mysqld]
default-time_zone = '+8:00'