技术文档

技术文档整理

---

Gradle 配置优先级（从高到低）

来源	示例	覆盖关系
命令行参数	-PmyProp=value	最高优先级
项目级 gradle.properties	./gradle.properties	覆盖用户级配置
用户级 gradle.properties	~/.gradle/gradle.properties	覆盖环境变量
环境变量	ORG_GRADLE_PROJECT_myProp=value	覆盖脚本默认值
settings.gradle	gradle.ext.sharedVersion	影响多项目构建
build.gradle	ext { myProp = ... }	最低优先级

---

Gradle 官方文档

• 基础知识
  Getting Started with Gradle
• API 文档
  • Settings 对象
  • Project 对象

---

Gradle 依赖缓存位置

~/.gradle/caches/modules-2/files-2.1/

---

Maven 配置

1. 配置文件路径

• 全局配置：${maven.home}/conf/settings.xml
• 用户配置：${user.home}/.m2/settings.xml

  ⚠️ 用户配置优先级更高（合并时覆盖相同配置）。

2. 仓库类型

类型	路径/协议	说明
本地仓库	${user.home}/.m2/repository	缓存下载的依赖或本地安装
远程仓库	file:// 或 https:// 协议	从远程服务器获取依赖

3. 常用插件

• maven-compiler-plugin：编译 Java 文件（官方提供）。
• kotlin-maven-plugin：编译 Kotlin 文件（Kotlin 官方提供）。
• spring-boot-maven-plugin：打包 Spring Boot 为可执行 JAR。

---

PNPM 全局安装配置

1. 设置全局路径

pnpm config set store-dir ~/.pnpm-store
pnpm config set global-bin-dir ~/.pnpm-global

• 将 ~/.pnpm-global 添加到 PATH：

  export PATH="$HOME/.pnpm-global:$PATH"

  Windows: $env:PATH += ";$env:USERPROFILE\.pnpm-global"

2. 配置环境变量

• Linux/macOS（添加到 ~/.bashrc 或 ~/.zshrc）：

  export PNPM_HOME="$HOME/.pnpm-global"
  export PATH="$PNPM_HOME:$PATH"

• Windows：通过系统设置添加 PNPM_HOME 变量。

3. 验证配置

pnpm config list  # 检查路径是否正确
pnpm add -g your-package-name  # 重新安装全局包

---

Shell 配置文件加载时机

文件	加载场景	典型用途
~/.bash_profile	仅登录 Shell（如 SSH、su -）	设置环境变量（PATH、JAVA_HOME）
~/.zshrc	所有交互式 Shell（非脚本运行）	配置别名、主题、插件（如 Oh My Zsh）

---