This week, I expanded my knowledge on the importance of code formatting in software development. Just as we rely on word processing software with spell check features to identify and correct spelling errors, developers should leverage code editors that offer formatting and linting capabilities to maintain code quality.
To enhance the quality of our code and reduce development time, it is essential for programmers to utilize static analysis tools. When collaborating on projects with multiple contributors, adherence to coding standards becomes crucial, as it allows others to read and understand the code more easily. This necessity has led to the emergence of various tools tailored to different programming languages. For my project this week, I chose to implement Prettier for my JavaScript codebase. In addition to formatting tools, a linter is also essential. A linter assists developers in identifying overlooked errors that may not affect the program's execution but can lead to significant issues in the code if left unchecked. For this purpose, I selected ESLint.
To use Prettier, I installed it locally in my project with the following command:
npm install --save-dev --save-exact prettier
Next, I created two configuration files: .prettierrc and .prettierignore:
I left it as an empty object because I want to use the default Prettier's setup without overriding any rules.
I included all the files and folders that I don't want Prettier will approach. Most of them are configuration files and self-generated files.
Notes:
npx prettier . --write
To use this, you just type this command:
npm run format
In addition to the local setup and command-line usage, Prettier can also be integrated into the code editor (such as VSCode) via an extension. Once installed, it automatically formats code upon saving a file.
ESLint is a tool designed to identify and report on patterns in ECMAScript/JavaScript code, aiming to enhance code consistency and minimize bugs. You can install and configure ESLint using:
npm init @eslint/config@latest
Upon executing this command, a series of questions will guide you through the setup in the terminal, and a new configuration file named .eslint.config.mjs will be created. Since I am using ESLint version 9.x, all configurations will be specified within this file. I also listed unnecessary files and folders for ESLint to ignore using the ignore property.
To streamline the linting process, I added a script in package.json for easier execution.
To run the script, you just type this command:
npm run lint
While the aforementioned setup suffices for individual projects, ensuring a uniform development environment for all contributors is vital in collaborative settings. Therefore, I created a .vscode folder in the root directory containing two files:
extensions.json: This file lists the necessary extensions that developers should install when opening the project, providing prompts upon project launch.
settings.json: This configuration ensures that:
By establishing the .vscode folder with settings.json and extensions.json, I ensure that all contributors share a consistent development environment, with Prettier and ESLint seamlessly integrated into Visual Studio Code. This setup facilitates automatic code formatting and linting according to the project’s configuration, simplifying the maintenance of code quality and consistency.
After running Prettier, I identified a few files that required manual adjustments, primarily adding commas to the last elements of objects.
Following the ESLint run, I discovered 13 issues, most of which were due to the use of the global object process, which does not require initialization. To resolve this, I added the following comment at the top of the affected files:
/* eslint-disable no-undef */
Additionally, there were some imported values that were not used; for these cases, I simply removed them.
Through my exploration of static analysis tools, I have gained a deeper understanding of their significance, particularly in collaborative projects. The primary goal of these tools is to facilitate teamwork and maintain high code quality, and I now appreciate how to effectively set up a project to integrate these essential tools from the outset.
The above is the detailed content of Beyond Spellcheck: How Static Analysis Tools Enhance Collaboration in Coding. For more information, please follow other related articles on the PHP Chinese website!